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

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.

Headers

AuthorizationstringRequired

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

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_errorbooleanOptionalDefaults to false
input_processor_timingdoubleOptional

The execution time for the TaskRun in seconds.

llm_call_timingdoubleOptional

The execution time for the TaskRun in seconds.

charged_creditsstringOptional

The total credits charged for the TaskRun.

Errors