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": "019fa2da-4790-712c-aaa2-cb8d287b620b",
3   "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
4   "session_id": "019fa2da-4790-7718-8edc-ae551b239242",
5   "user_id": "0190c234-1111-2222-3333-444444444444",
6   "input_tokens": 1840,
7   "output_tokens": 410,
8   "total_tokens": 2250,
9   "charged_credits": "4.10",
10   "created": "2026-07-27T09:14:02Z",
11   "completed": "2026-07-27T09:14:11Z",
12   "duration_ms": 9130,
13   "status": "completed",
14   "is_error": false,
15   "task_tools_invoked": [
16     {
17       "task_id": "019df7a2-44a0-7f6b-8a18-d81df57049d0",
18       "task_name": "Customer Support Analyzer",
19       "task_revision_id": "019df7a2-44a0-75d6-b036-4e86f6d45302",
20       "task_run_id": "019fa2da-4790-798a-9530-76940e914d17",
21       "is_error": false,
22       "is_formatter": false,
23       "duration_ms": 1120
24     },
25     {
26       "task_id": "019df7a2-44a0-7186-92a6-a8e45e78537b",
27       "task_name": "Draft Support Reply",
28       "task_revision_id": "019df7a2-44a0-78c4-ba7b-6ae382a6253a",
29       "task_run_id": "019fa2da-4790-7bff-bc7a-c397d193f25e",
30       "is_error": false,
31       "is_formatter": true,
32       "duration_ms": 2380
33     }
34   ],
35   "is_chaos_run": false,
36   "task_agent_revision_id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
37   "adk_session_user_id": "0190c234-1111-2222-3333-444444444444",
38   "invocation_id": "019fa2da-4790-7e73-b7af-bfd124a96ed6",
39   "invocation_ids": [
40     "019fa2da-4790-7e73-b7af-bfd124a96ed6"
41   ],
42   "is_continuation": false,
43   "primary_llm_model_id": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
44   "fallback_llm_model_id": "af2a9bbf-5f36-4b12-bd3f-92c57be96dec",
45   "used_fallback_model": false,
46   "total_charged_credits": "4.10",
47   "approval_request_ids": [],
48   "approval_requests": [],
49   "had_task_tool_fail": false,
50   "had_mcp_tool_fail": false,
51   "had_integration_tool_fail": false,
52   "integration_tools_invoked": [
53     {
54       "integration_id": "019df7a2-44a0-7a75-ae4f-4c8edcdac22e",
55       "integration_name": "Customer Database",
56       "integration_type": "google_sheets",
57       "integration_tool_id": "019df7a2-44a0-7b09-afd0-c59cbc20126d",
58       "tool_name": "sheets_spreadsheets_values_get",
59       "principal_type": "project_default",
60       "is_error": false,
61       "duration_ms": 640
62     }
63   ],
64   "phase_timings": [
65     {
66       "phase": "llm_inference",
67       "start_ms": 0,
68       "end_ms": 1450
69     },
70     {
71       "phase": "integration_tool_execution",
72       "start_ms": 1450,
73       "end_ms": 2090,
74       "call_id": "call-2b3c4d5e6f70",
75       "tool_name": "sheets_spreadsheets_values_get",
76       "integration_name": "Customer Database"
77     },
78     {
79       "phase": "task_tool_execution",
80       "start_ms": 2090,
81       "end_ms": 4470,
82       "call_id": "call-3c4d5e6f7081",
83       "task_run_id": "019fa2da-4790-7bff-bc7a-c397d193f25e"
84     }
85   ],
86   "context_usage": {
87     "estimator_version": "task_agent_context_usage_v1",
88     "input_tokens": {
89       "provider_total": 1840,
90       "observed_provider_total": 1840,
91       "estimated_total": 1890,
92       "uncategorized": 0,
93       "breakdown": {
94         "conversation_history": 0,
95         "current_user_message": 23,
96         "input_files": 0,
97         "instructions": 153,
98         "integrations": 0,
99         "mcp_tools": 0,
100         "registered_tools": 0,
101         "runtime_file": 108,
102         "skills": 0,
103         "task_tools": 20
104       }
105     },
106     "schema_version": 1,
107     "input_files": {
108       "estimated_tokens": 0,
109       "file_count": 0,
110       "text_file_count": 0,
111       "binary_file_count": 0,
112       "total_bytes": 0
113     },
114     "output_tokens": {
115       "provider_total": 410,
116       "observed_provider_total": 410
117     },
118     "runtime_components": {
119       "integrations": {
120         "estimated_tokens": 0,
121         "tool_declarations": {
122           "estimated_tokens": 0,
123           "count": 0,
124           "unavailable_count": 0,
125           "error_count": 0
126         },
127         "provenance": {}
128       },
129       "mcp_tools": {
130         "estimated_tokens": 0,
131         "tool_declarations": {
132           "estimated_tokens": 0,
133           "count": 0,
134           "unavailable_count": 0,
135           "error_count": 0
136         },
137         "provenance": {}
138       },
139       "registered_tools": {
140         "estimated_tokens": 0,
141         "tool_declarations": {
142           "estimated_tokens": 0,
143           "count": 0,
144           "unavailable_count": 0,
145           "error_count": 0
146         },
147         "provenance": {}
148       },
149       "runtime_file": {
150         "estimated_tokens": 108,
151         "tool_declarations": {
152           "estimated_tokens": 108,
153           "count": 1,
154           "unavailable_count": 0,
155           "error_count": 0
156         },
157         "provenance": {
158           "manual": 108
159         }
160       },
161       "skills": {
162         "estimated_tokens": 0,
163         "tool_declarations": {
164           "estimated_tokens": 0,
165           "count": 0,
166           "unavailable_count": 0,
167           "error_count": 0
168         },
169         "loaded_payloads": 0,
170         "provenance": {}
171       },
172       "task_tools": {
173         "estimated_tokens": 20,
174         "tool_declarations": {
175           "estimated_tokens": 20,
176           "count": 1,
177           "unavailable_count": 0,
178           "error_count": 0
179         },
180         "provenance": {
181           "manual": 20
182         }
183       }
184     },
185     "metadata": {
186       "request_count": 1,
187       "partial": false,
188       "provider_usage_missing": false,
189       "provider_usage_complete": true,
190       "observed_provider_total_tokens": 2250,
191       "estimation_truncated": false,
192       "truncated_estimate_count": 0,
193       "estimation_methods": [
194         "utf8_bytes_div_4"
195       ]
196     }
197   },
198   "last_activity_at": "2026-07-27T09:14:11Z",
199   "trigger_type": "api",
200   "model_usages": [
201     {
202       "id": "019fa2da-4790-7fa0-9552-00540687d1cb",
203       "task_agent_run_id": "019fa2da-4790-712c-aaa2-cb8d287b620b",
204       "llm_model_id": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
205       "usage_scope": "reasoning",
206       "usage_type": "primary",
207       "input_tokens": 1840,
208       "output_tokens": 410,
209       "total_tokens": 2250,
210       "charged_credits": "4.10",
211       "call_count": 3,
212       "created": "2026-07-27T09:14:02Z",
213       "modified": "2026-07-27T09:14:11Z"
214     }
215   ],
216   "files": []
217 }

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

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

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

is_chaos_runbooleanRead-only

task_agent_revision_idstring or nullOptionalformat: "uuid"

adk_session_user_idstring or nullOptional

invocation_idstring or nullOptional

invocation_idslist of strings or nullOptional

is_continuationbooleanOptionalDefaults to false

primary_llm_model_idstring or nullOptionalformat: "uuid"

fallback_llm_model_idstring or nullOptionalformat: "uuid"

used_fallback_modelbooleanOptionalDefaults to false

primary_failure_reasonstring or nullOptional

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

approval_request_idslist of stringsOptional

IDs of approval requests linked to this TaskAgentRun.

approval_requestslist of objectsOptional

Compact approval request summaries linked to this TaskAgentRun.

had_task_tool_failbooleanOptionalDefaults to false

had_mcp_tool_failbooleanOptionalDefaults to false

had_integration_tool_failbooleanOptionalDefaults to false

skills_activatedlist of objects or nullOptional

mcp_tools_invokedlist of objects or nullOptional

integration_tools_invokedlist of objects or nullOptional

phase_timingslist of objects or nullOptional

context_usageobject or nullOptional

chaos_configobject or nullOptional

Run-scoped TaskAgent chaos policy.

chaos_eventslist of objects or nullOptional

termination_reasonstring or nullOptional

last_activity_atstring or nullOptional

trigger_typestringOptionalDefaults to manual

How the run was triggered. Non-trigger sources include manual, api, and slack; trigger executions use their trigger type value.

model_usageslist of objectsOptional

fileslist of objectsOptionalDefaults to []

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