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.