Get Task Agent Run

GET

/org/:org_id/project/:project_id/task-agent/:task_agent_id/run/:run_id

GET

/api/v1/org/:org_id/project/:project_id/task-agent/:task_agent_id/run/:run_id

$ curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task-agent/task_agent_id/run/run_id \
>      -H "Authorization: Bearer <token>"

1 {
2   "id": "string",
3   "task_agent_id": "string",
4   "session_id": "string",
5   "user_id": "string",
6   "input_tokens": 1,
7   "output_tokens": 1,
8   "total_tokens": 1,
9   "charged_credits": "string",
10   "created": "string",
11   "completed": "string",
12   "duration_ms": 1,
13   "status": "running",
14   "is_error": true,
15   "task_tools_invoked": [
16     {
17       "task_id": "string",
18       "task_name": "string",
19       "task_revision_id": "string",
20       "task_run_id": "string",
21       "is_error": false,
22       "is_formatter": false,
23       "duration_ms": 1,
24       "error_message": "string"
25     }
26   ],
27   "task_agent_revision_id": "string",
28   "invocation_id": "string",
29   "is_continuation": false,
30   "primary_llm_model_id": "string",
31   "fallback_llm_model_id": "string",
32   "used_fallback_model": false,
33   "primary_failure_reason": "string",
34   "total_charged_credits": "string",
35   "had_task_tool_fail": false,
36   "had_mcp_tool_fail": false,
37   "had_integration_tool_fail": false,
38   "skills_activated": [
39     {
40       "skill_id": "string",
41       "skill_slug": "string",
42       "skill_display_name": "string",
43       "activated": true,
44       "skill_revision_id": "string"
45     }
46   ],
47   "mcp_tools_invoked": [
48     {
49       "server_id": "string",
50       "server_name": "string",
51       "tool_name": "string",
52       "is_error": false,
53       "duration_ms": 1,
54       "error_message": "string"
55     }
56   ],
57   "integration_tools_invoked": [
58     {
59       "integration_id": "string",
60       "integration_name": "string",
61       "integration_type": "string",
62       "integration_tool_id": "string",
63       "tool_name": "string",
64       "principal_type": "string",
65       "is_error": false,
66       "duration_ms": 1,
67       "error_message": "string"
68     }
69   ],
70   "phase_timings": [
71     {
72       "phase": "llm_inference",
73       "start_ms": 1,
74       "end_ms": 1,
75       "call_id": "string",
76       "task_run_id": "string",
77       "tool_name": "string",
78       "server_name": "string",
79       "integration_name": "string",
80       "trigger": "string",
81       "compaction_event_id": "string",
82       "input_tokens": 1,
83       "output_tokens": 1,
84       "total_tokens": 1,
85       "token_threshold": 1,
86       "event_retention_size": 1
87     }
88   ],
89   "context_usage": {
90     "estimator_version": "string",
91     "input_tokens": {
92       "provider_total": 1,
93       "observed_provider_total": 1,
94       "estimated_total": 0,
95       "uncategorized": 1,
96       "breakdown": {}
97     },
98     "schema_version": 1,
99     "input_files": {
100       "estimated_tokens": 0,
101       "file_count": 0,
102       "text_file_count": 0,
103       "binary_file_count": 0,
104       "total_bytes": 0
105     },
106     "output_tokens": {
107       "provider_total": 1,
108       "observed_provider_total": 1
109     },
110     "runtime_components": {},
111     "metadata": {
112       "request_count": 0,
113       "partial": false,
114       "provider_usage_missing": false,
115       "provider_usage_complete": false,
116       "observed_provider_total_tokens": 1,
117       "estimation_truncated": false,
118       "truncated_estimate_count": 0,
119       "max_estimated_part_bytes": 1,
120       "estimation_methods": [
121         "string"
122       ]
123     }
124   },
125   "termination_reason": "string",
126   "last_activity_at": "string",
127   "model_usages": [
128     {
129       "id": "string",
130       "task_agent_run_id": "string",
131       "llm_model_id": "string",
132       "usage_scope": "reasoning",
133       "usage_type": "primary",
134       "input_tokens": 1,
135       "output_tokens": 1,
136       "total_tokens": 1,
137       "charged_credits": "string",
138       "call_count": 1,
139       "created": "string",
140       "modified": "string"
141     }
142   ],
143   "files": [
144     {
145       "original_filename": "contract.pdf",
146       "stored_filename": "b4a66744-6e99-4ad4-8aff-4d953bb0b9cf.pdf",
147       "content_type": "application/pdf",
148       "download_url": "/org/abc123.../project/def456.../task/ghi789.../run/jkl012.../file/b4a66744-6e99-4ad4-8aff-4d953bb0b9cf.pdf",
149       "size_bytes": 1024576,
150       "source": "input",
151       "source_task_name": "quote-image-generator",
152       "source_task_run_id": "019beb35-3976-e7da-4595-56338335cd5a"
153     }
154   ]
155 }

Get a single execution run for a Task Agent by run ID. Returns the same run metadata shape as the run listing endpoint, including status, token usage, files, tool invocation summaries, phase timings, fallback metadata, and model usage rows when available.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

task_agent_idstringRequiredformat: "uuid"

The task agent ID

run_idstringRequiredformat: "uuid"

The task agent run ID

Response

Task Agent run

idstringformat: "uuid"

task_agent_idstringformat: "uuid"

session_idstring

ADK session ID (string format).

user_idstring or nullformat: "uuid"

input_tokensinteger

output_tokensinteger

total_tokensinteger

charged_creditsstring or nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"

createdstring

completedstring or null

duration_msinteger or null

statusenum

Status of a TaskAgent run.

is_errorboolean

task_tools_invokedlist of objects or null

task_agent_revision_idstring or nullformat: "uuid"

invocation_idstring or null

is_continuationbooleanDefaults to false

primary_llm_model_idstring or nullformat: "uuid"

fallback_llm_model_idstring or nullformat: "uuid"

used_fallback_modelbooleanDefaults to false

primary_failure_reasonstring or null

total_charged_creditsstring or nullformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"

had_task_tool_failbooleanDefaults to false

had_mcp_tool_failbooleanDefaults to false

had_integration_tool_failbooleanDefaults to false

skills_activatedlist of objects or null

mcp_tools_invokedlist of objects or null

integration_tools_invokedlist of objects or null

phase_timingslist of objects or null

context_usageobject or null

termination_reasonstring or null

last_activity_atstring or null

model_usageslist of objects

fileslist of objects

Files associated with this agent run (both uploaded and generated by task tools)

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error