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

Fallback Model Information:

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)

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 Fallback Model Information: - `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) 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.

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.

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.

is_errorboolean or nullDefaults to false

llm_retriesinteger or nullDefaults to 0

Number of retry attempts made during LLM execution.

used_fallback_modelboolean or nullDefaults 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

reporting_groupobject or null

The reporting group associated with this task run

Errors

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

Fallback Model Information:

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)

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

1	import requests
2
3	url = "https://app.rightbrain.ai/api/v1/org/123e4567-e89b-12d3-a456-426614174000/project/123e4567-e89b-12d3-a456-426614174001/task/01909843-3596-da54-4756-28af46917e74/run/129c78d7-2e1f-4a77-adf3-68d69b0a3c71"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"task_id": "0190a234-8dc6-6d08-aea9-928fcecad8f1",
3	"task_revision_id": "0190a234-8dc6-6d08-aea9-928fcecad8f3",
4	"response": {
5	"sentiment": "positive",
6	"confidence": 0.92
7	},
8	"run_data": {
9	"submitted": {
10	"text": "Analyze this text for sentiment"
11	},
12	"files": []
13	},
14	"id": "0190b234-1111-2222-3333-444444444444",
15	"created": "2024-01-16T13:33:25.247662",
16	"input_tokens": 125,
17	"output_tokens": 25,
18	"total_tokens": 150,
19	"input_processor_timing": 1.1,
20	"llm_call_timing": 1.2,
21	"charged_credits": "0.85",
22	"is_error": false,
23	"llm_retries": 0,
24	"used_fallback_model": false
25	}