runs

List Runs

List all runs.

Authentication

AuthorizationBearer

Header authentication of the form Bearer <token>

Query parameters

agent_idstring or nullOptional
The unique identifier of the agent associated with the run.
agent_idslist of strings or nullOptionalDeprecated

The unique identifiers of the agents associated with the run. Deprecated in favor of agent_id field.

statuseslist of strings or nullOptional
Filter runs by status. Can specify multiple statuses.
backgroundboolean or nullOptional
If True, filters for runs that were created in background mode.
stop_reasonenum or nullOptional
Filter runs by stop reason.
beforestring or nullOptional
Run ID cursor for pagination. Returns runs that come before this run ID in the specified sort order
afterstring or nullOptional
Run ID cursor for pagination. Returns runs that come after this run ID in the specified sort order
limitinteger or nullOptionalDefaults to 100
Maximum number of runs to return
orderenumOptionalDefaults to desc
Sort order for runs by creation time. 'asc' for oldest first, 'desc' for newest first
Allowed values:
order_by"created_at"Optional
Field to sort by
activebooleanOptionalDefaults to false
Filter for active runs.
ascendingbooleanOptionalDefaults to falseDeprecated

Whether to sort agents oldest to newest (True) or newest to oldest (False, default). Deprecated in favor of order field.

Response

Successful Response
agent_idstring
The unique identifier of the agent associated with the run.
idstring or nullformat: "^(job|run)-[a-fA-F0-9]{8}"

The human-friendly ID of the Run

statusenum or null
The current status of the run.
Allowed values:
created_atstring or nullformat: "date-time"
The timestamp when the run was created.
completed_atstring or nullformat: "date-time"
The timestamp when the run was completed.
base_template_idstring or null
The base template ID that the run belongs to.
backgroundboolean or null
Whether the run was created in background mode.
metadatamap from strings to any or null
Additional metadata for the run.
request_configobject or null
The request configuration for the run.
stop_reasonenum or null
The reason why the run was stopped.
callback_urlstring or null
If set, POST to this URL when the run completes.
callback_sent_atstring or nullformat: "date-time"
Timestamp when the callback was last attempted.
callback_status_codeinteger or null
HTTP status code returned by the callback endpoint.
callback_errorstring or null
Optional error message from attempting to POST the callback endpoint.
ttft_nsinteger or null
Time to first token for a run in nanoseconds
total_duration_nsinteger or null
Total run duration in nanoseconds

Errors