List task runs
Returns a paginated list of task runs. Supports filtering by agent, credential, source, task, workflow, status, result, and date range.
Authorizations
Secret key (sk_live_...)
Query Parameters
Maximum number of items to return (1-100, default 20)
Cursor from a previous response for pagination.
Filter by status: queued, running, canceling, interaction_required, review_required, completed, canceled, failed
Filter by source ID
Filter by run result: success, failure, unknown. Maps to the result field on the task run object.
Unique identifier for the agent (prefixed with agt_).
Unique identifier for the credential (prefixed with cred_).
Unique identifier for the task (prefixed with task_).
Filter by workflow ID.
Return runs created after this timestamp (ISO 8601).
Return runs created before this timestamp (ISO 8601).
Free-text search matching task name, task ID, or task run ID.
Response
OK
Array of resource objects for the current page.
true if there are more results beyond this page.
Opaque cursor string to pass as the cursor query parameter on the next request. null when there are no more pages.
Unique identifier for the API request.