Sign in
runs

List Runs

List all runs.

get/v1/runs/

Query parameters

agent_idsstring[] nullable

The unique identifier of the agent associated with the run.

The unique identifier of the agent associated with the run.

backgroundboolean nullable

If True, filters for runs that were created in background mode.

If True, filters for runs that were created in background mode.

stop_reason'end_turn' | 'error' | 'llm_api_error' | 'invalid_llm_response' | 'invalid_tool_call' | 'max_steps' | 'no_tool_call' | 'tool_rule' | 'cancelled' | 'requires_approval'

Filter runs by stop reason.

afterstring nullable

Cursor for pagination

Cursor for pagination

beforestring nullable

Cursor for pagination

Cursor for pagination

limitinteger nullable

Maximum number of runs to return

Maximum number of runs to return

activeboolean

Filter for active runs.

Filter for active runs.

ascendingboolean

Whether to sort agents oldest to newest (True) or newest to oldest (False, default)

Whether to sort agents oldest to newest (True) or newest to oldest (False, default)

Response

Successful Response

created_by_idstring nullable

The id of the user that made this object.

last_updated_by_idstring nullable

The id of the user that made this object.

created_atstring date-time

The unix timestamp of when the job was created.

updated_atstring date-time nullable

The timestamp when the object was last updated.

status'created' | 'running' | 'completed' | 'failed' | 'pending' | 'cancelled' | 'expired'

Status of the job.

completed_atstring date-time nullable

The unix timestamp of when the job was completed.

stop_reason'end_turn' | 'error' | 'llm_api_error' | 'invalid_llm_response' | 'invalid_tool_call' | 'max_steps' | 'no_tool_call' | 'tool_rule' | 'cancelled' | 'requires_approval'
metadataobject nullable

The metadata of the job.

job_type'job' | 'run' | 'batch'
callback_urlstring nullable

If set, POST to this URL when the job completes.

callback_sent_atstring date-time nullable

Timestamp when the callback was last attempted.

callback_status_codeinteger nullable

HTTP status code returned by the callback endpoint.

callback_errorstring nullable

Optional error message from attempting to POST the callback endpoint.

ttft_nsinteger nullable

Time to first token for a run in nanoseconds

total_duration_nsinteger nullable

Total run duration in nanoseconds

idstring

The human-friendly ID of the Run

Example response

[
  {
    "id": "run-123e4567-e89b-12d3-a456-426614174000"
  }
]

Changes