List Runs
List all runs.
Headers
Authorization
Header authentication of the form Bearer <token>
Query parameters
agent_id
The unique identifier of the agent associated with the run.
agent_idsDeprecated
The unique identifiers of the agents associated with the run. Deprecated in favor of agent_id field.
background
If True, filters for runs that were created in background mode.
stop_reason
Filter runs by stop reason.
after
Cursor for pagination
before
Cursor for pagination
limit
Maximum number of runs to return
active
Filter for active runs.
ascending
Whether to sort agents oldest to newest (True) or newest to oldest (False, default)
Response
Successful Response
agent_id
The unique identifier of the agent associated with the run.
id
The human-friendly ID of the Run
status
The current status of the run.
Allowed values:
created_at
The timestamp when the run was created.
completed_at
The timestamp when the run was completed.
background
Whether the run was created in background mode.
metadata
Additional metadata for the run.
request_config
The request configuration for the run.
stop_reason
The reason why the run was stopped.
callback_url
If set, POST to this URL when the run completes.
callback_sent_at
Timestamp when the callback was last attempted.
callback_status_code
HTTP status code returned by the callback endpoint.
callback_error
Optional error message from attempting to POST the callback endpoint.
ttft_ns
Time to first token for a run in nanoseconds
total_duration_ns
Total run duration in nanoseconds