Skip to content

brain_daemon_run

Trigger an immediate run for a daemon and return its current status

Tool

brain_daemon_run

Trigger an immediate run for a daemon and return its current status

Trigger an immediate run for a daemon and return its current status

Behavior

HTTP
POST /brain/daemons/:id/run

Arguments

Name
Type
Required
Description
id
string
•
Id of the ingestion daemon to act on, as returned by brain_daemons_list

Response

Field
Type
Always
Description
done
boolean
•
True once the run has finished, whether it succeeded or failed
runId
string
•
Id of the run being reported; null when this daemon has never run
status
string
•
Where the run stands: 'queued' waiting to start, 'running' in progress, 'done' finished, 'failed' gave up, 'none' this daemon has never run
sources
array
•
Per-source progress as the connector reported it; the shape differs by connector type and is meant for display, not for binding a step to
progress
object
•
Document counts for the run; null when nothing has been counted yet
routedTo
string
•
Which lane the run went to: 'realtime' finishes in minutes, 'batch' queues the work with the model provider and can take hours
triggered
boolean
•
True when this call actually started a run; false when one was already in flight and nothing new was started
triggerError
string
—
Why the run could not be started; absent when it was started

Try it

Trigger an immediate run for a daemon and return its current status.

When to use

Trigger an immediate run for a daemon and return its current status

Example

Ask your agent something like this:

Trigger an immediate run for a daemon and return its current status.

The agent will invoke brain_daemon_run with these arguments:

{
  "id": "<id>"
}

Esc

Start typing to search the docs.

↑↓navigate↵select