Fetch a Task Run | Rightbrain Docs | Transform AI Ideas into Production Tasks

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, credits charged)
Structured output and processing metadata
Error information if the run failed
Fallback model information if the primary model failed

Response Fields:

Timing Metrics:

input_processor_timing: Time in seconds spent running input processors (e.g., 0.00015282)
llm_call_timing: Time in seconds for the LLM API call (e.g., 1.346)

Resource Usage:

charged_credits: Credits charged for this execution as a string (e.g., "1.00")
input_tokens: Number of input tokens processed
output_tokens: Number of output tokens generated
total_tokens: Combined token count

Retry & Fallback Information:

llm_retries: Number of retry attempts made before success or failure
used_fallback_model: Boolean indicating if fallback model was used
primary_failure_reason: Reason why the primary model failed (if applicable)
fallback_llm_model_id: ID of the fallback model used (if applicable)

Input Data:

run_data.submitted: The original input parameters as submitted

This endpoint is useful for:

Monitoring task execution progress
Debugging failed runs and understanding failover behavior
Auditing task usage and performance
Retrieving task results
Analyzing reliability and fallback model usage

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

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, credits charged) - Structured output and processing metadata - Error information if the run failed - Fallback model information if the primary model failed **Response Fields:** *Timing Metrics:* - `input_processor_timing`: Time in seconds spent running input processors (e.g., `0.00015282`) - `llm_call_timing`: Time in seconds for the LLM API call (e.g., `1.346`) *Resource Usage:* - `charged_credits`: Credits charged for this execution as a string (e.g., `"1.00"`) - `input_tokens`: Number of input tokens processed - `output_tokens`: Number of output tokens generated - `total_tokens`: Combined token count *Retry & Fallback Information:* - `llm_retries`: Number of retry attempts made before success or failure - `used_fallback_model`: Boolean indicating if fallback model was used - `primary_failure_reason`: Reason why the primary model failed (if applicable) - `fallback_llm_model_id`: ID of the fallback model used (if applicable) *Input Data:* - `run_data.submitted`: The original input parameters as submitted This endpoint is useful for: - Monitoring task execution progress - Debugging failed runs and understanding failover behavior - Auditing task usage and performance - Retrieving task results - Analyzing reliability and fallback model usage 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 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.

task_run_idstringRequiredformat: "uuid"

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.

responsestring or map from strings to any

The structured response from the Task execution.

run_dataobject

Additional data about the Task execution, including submitted inputs.

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.

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 nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"

The total credits charged for the TaskRun.

fileslist of objects

List of file metadata objects with enriched information including download URLs.

is_errorbooleanDefaults to false

llm_retriesintegerDefaults to 0

Number of retry attempts made during LLM execution.

used_fallback_modelbooleanDefaults to false

Whether the fallback model was used

primary_failure_reasonstring or null

Reason the primary model failed

fallback_llm_model_idstring or nullformat: "uuid"

Fallback model that was used

user_idstring or nullformat: "uuid"

The unique identifier of the User who executed the task.

reporting_group_idstring or nullformat: "uuid"

The ID of the reporting group to associate with this task run

referencestring or null<=64 characters

An optional reference identifier for this task run

context_idstring or null<=64 characters

An optional context ID for grouping related task runs

reporting_groupobject or null

The reporting group associated with this task run

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error