API ReferenceTasks

List Task Runs

Retrieve a paginated list of task runs for a specific task. Task runs provide an audit trail of all task executions, including: - Input parameters used - Execution status and timing - Resource usage metrics (tokens, credits) - Output results - Error information for failed runs - Fallback model usage information This endpoint supports: - Pagination using cursor-based navigation - Filtering by task revision - Sorting by creation time (newest first) Common use cases: 1. Monitoring task execution history 2. Auditing task usage and performance 3. Debugging task behavior across multiple runs 4. Analyzing task output patterns 5. Tracking fallback model usage and reliability

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path Parameters

org_idstringRequiredformat: "uuid"
The unique identifier of the organization.
project_idstringRequiredformat: "uuid"
The unique identifier of the project.
task_idstringRequiredformat: "uuid"
The specific Task to reference.

Query Parameters

page_limitintegerOptional1-100Defaults to 100

The maximum number of items to return per page. Defaults to 100 if not specified.

cursorstringOptionalformat: "uuid"

A cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

statusenumOptional
Filter by task run status
Allowed values:
task_revision_idstringOptionalformat: "uuid"
Filter task runs by revision ID

Response

Successfully retrieved task runs
resultslist of objects
The list of items returned for the current page.
paginationobject or null
Contains pagination information for the result set.

Errors