Fetch a Task Run
Retrieve detailed information about a specific task run.
Task runs provide a complete record of task executions, including:
- Input parameters and configuration used
- Execution status and timing information
- Resource usage metrics (e.g., tokens consumed)
- Structured output and processing metadata
- Error information if the run failed
This endpoint is useful for:
- Monitoring task execution progress
- Debugging failed runs
- Auditing task usage and performance
- Retrieving task results
Errors:
- Returns 400 if the task run ID is not a valid UUID format
- Returns 422 if the request body fails validation
- Returns 404 if the task run is not found
- Returns 403 if the user lacks permission to access the task run
Path parameters
The unique identifier of the organization.
The unique identifier of the project.
The specific Task to reference.
The specific Task Run to reference.
Headers
Bearer authentication of the form Bearer <token>, where token is your auth token.
Response
Successfully retrieved task run information
The unique identifier of the Task associated with this run.
The unique identifier of the Task Revision associated with this run.
The structured response from the Task execution.
Additional data about the Task execution, including submitted inputs and processed files.
The unique identifier of the Task Run.
The timestamp when the Task Run was created.
The number of tokens submit as input to the model.
The number of tokens generated and output by the model.
The total token usage for the TaskRun.
The execution time for the TaskRun in seconds.
The execution time for the TaskRun in seconds.