Tasks

Fetch a Task Run

GA
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

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

org_idstringRequired
The unique identifier of the organization.
project_idstringRequired
The unique identifier of the project.
task_idstringRequired
The specific Task to reference.
task_run_idstringRequired
The specific Task Run to reference.

Response

Successfully retrieved task run information
task_idstringformat: "uuid"
The unique identifier of the Task associated with this run.
task_revision_idstringformat: "uuid"
The unique identifier of the Task Revision associated with this run.
responsemap from strings to any
The structured response from the Task execution.
run_dataobject
Additional data about the Task execution, including submitted inputs and processed files.
idstringformat: "uuid"
The unique identifier of the Task Run.
createdstring
The timestamp when the Task Run was created.
input_tokensinteger
The number of tokens submit as input to the model.
output_tokensinteger
The number of tokens generated and output by the model.
total_tokensinteger
The total token usage for the TaskRun.
is_errorboolean or nullDefaults to false
input_processor_timingdouble or null
The execution time for the TaskRun in seconds.
llm_call_timingdouble or null
The execution time for the TaskRun in seconds.
charged_creditsstring or null
The total credits charged for the TaskRun.

Errors