runs

List Runs

List all runs.

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Query parameters

agent_idslist of strings or nullOptional
The unique identifier of the agent associated with the run.
backgroundboolean or nullOptional
If True, filters for runs that were created in background mode.
afterstring or nullOptional
Cursor for pagination
beforestring or nullOptional
Cursor for pagination
limitinteger or nullOptionalDefaults to 50
Maximum number of runs to return
ascendingbooleanOptionalDefaults to false

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

Response

Successful Response
created_by_idstring or null
The id of the user that made this object.
last_updated_by_idstring or null
The id of the user that made this object.
created_atstring or nullformat: "date-time"
The unix timestamp of when the job was created.
updated_atstring or nullformat: "date-time"
The timestamp when the object was last updated.
statusenum or null
The status of the job.
completed_atstring or nullformat: "date-time"
The unix timestamp of when the job was completed.
metadatamap from strings to any or null
The metadata of the job.
job_typeenum or null
Allowed values:
callback_urlstring or null
If set, POST to this URL when the job 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
idstring or nullformat: "^(job|run)-[a-fA-F0-9]{8}"

The human-friendly ID of the Run

request_configobject or null
The request configuration for the run.

Errors