Fetch a Task Run
GARetrieve 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
org_id
The unique identifier of the organization.
project_id
The unique identifier of the project.
task_id
The specific Task to reference.
task_run_id
The specific Task Run to reference.
Headers
Authorization
Bearer authentication of the form Bearer <token>, where token is your auth token.
Response
Successfully retrieved task run information
task_id
The unique identifier of the Task associated with this run.
task_revision_id
The unique identifier of the Task Revision associated with this run.
response
The structured response from the Task execution.
run_data
Additional data about the Task execution, including submitted inputs and processed files.
id
The unique identifier of the Task Run.
created
The timestamp when the Task Run was created.
input_tokens
The number of tokens submit as input to the model.
output_tokens
The number of tokens generated and output by the model.
total_tokens
The total token usage for the TaskRun.
is_error
input_processor_timing
The execution time for the TaskRun in seconds.
llm_call_timing
The execution time for the TaskRun in seconds.
charged_credits
The total credits charged for the TaskRun.