Tasks
List task runs
List all runs for a task with cursor-based pagination.
<Note>This endpoint is in beta, read more here.</Note>
get/v2/tasks/{task_id}/runs
Path parameters
task_idstring required
A universally unique identifier (base64-encoded opaque string).
Example:RW50aXR5OjEyMzQ1
The unique task identifier (base64)
Query parameters
status'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
Status of a task run.
- PENDING - The run has been created but not yet started.
- RUNNING - The run is currently in progress.
- COMPLETED - The run finished successfully.
- FAILED - The run encountered an error and stopped.
- CANCELLED - The run was cancelled before completion.
Filter by run status: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED
limitinteger
Maximum items to return
cursorstring
Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.
Response
Returns a list of task run objects