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   "adk_session_user_id": "string",
29   "invocation_id": "string",
30   "invocation_ids": [
31     "string"
32   ],
33   "is_continuation": false,
34   "primary_llm_model_id": "string",
35   "fallback_llm_model_id": "string",
36   "used_fallback_model": false,
37   "primary_failure_reason": "string",
38   "total_charged_credits": "string",
39   "approval_request_ids": [
40     "string"
41   ],
42   "approval_requests": [
43     {
44       "id": "string",
45       "status": "pending",
46       "tool_type": "task",
47       "tool_name": "string",
48       "requested_at": "string",
49       "decided_at": "string",
50       "requested_by_user_id": "string",
51       "decided_by_user_id": "string",
52       "decision_note": "string"
53     }
54   ],
55   "had_task_tool_fail": false,
56   "had_mcp_tool_fail": false,
57   "had_integration_tool_fail": false,
58   "skills_activated": [
59     {
60       "skill_id": "string",
61       "skill_slug": "string",
62       "skill_display_name": "string",
63       "activated": true,
64       "skill_revision_id": "string"
65     }
66   ],
67   "mcp_tools_invoked": [
68     {
69       "server_id": "string",
70       "server_name": "string",
71       "tool_name": "string",
72       "is_error": false,
73       "duration_ms": 1,
74       "error_message": "string"
75     }
76   ],
77   "integration_tools_invoked": [
78     {
79       "integration_id": "string",
80       "integration_name": "string",
81       "integration_type": "string",
82       "integration_tool_id": "string",
83       "tool_name": "string",
84       "principal_type": "string",
85       "is_error": false,
86       "duration_ms": 1,
87       "error_message": "string"
88     }
89   ],
90   "phase_timings": [
91     {
92       "phase": "llm_inference",
93       "start_ms": 1,
94       "end_ms": 1,
95       "call_id": "string",
96       "task_run_id": "string",
97       "tool_name": "string",
98       "server_name": "string",
99       "integration_name": "string",
100       "trigger": "string",
101       "compaction_event_id": "string",
102       "input_tokens": 1,
103       "output_tokens": 1,
104       "total_tokens": 1,
105       "token_threshold": 1,
106       "event_retention_size": 1
107     }
108   ],
109   "context_usage": {
110     "estimator_version": "string",
111     "input_tokens": {
112       "provider_total": 1,
113       "observed_provider_total": 1,
114       "estimated_total": 0,
115       "uncategorized": 1,
116       "breakdown": {}
117     },
118     "schema_version": 1,
119     "input_files": {
120       "estimated_tokens": 0,
121       "file_count": 0,
122       "text_file_count": 0,
123       "binary_file_count": 0,
124       "total_bytes": 0
125     },
126     "output_tokens": {
127       "provider_total": 1,
128       "observed_provider_total": 1
129     },
130     "cache": {
131       "enabled": false,
132       "gross_input_tokens": 0,
133       "cached_input_tokens": 0,
134       "cached_input_billing_ratio": "string",
135       "billing_input_tokens": 1,
136       "billing_cached_read_input_tokens": 1,
137       "requests_with_cached_tokens": 0
138     },
139     "runtime_components": {},
140     "metadata": {
141       "request_count": 0,
142       "partial": false,
143       "provider_usage_missing": false,
144       "provider_usage_complete": false,
145       "observed_provider_total_tokens": 1,
146       "estimation_truncated": false,
147       "truncated_estimate_count": 0,
148       "max_estimated_part_bytes": 1,
149       "estimation_methods": [
150         "string"
151       ]
152     }
153   },
154   "termination_reason": "string",
155   "last_activity_at": "string",
156   "trigger_type": "manual",
157   "model_usages": [
158     {
159       "id": "string",
160       "task_agent_run_id": "string",
161       "llm_model_id": "string",
162       "usage_scope": "reasoning",
163       "usage_type": "primary",
164       "input_tokens": 1,
165       "output_tokens": 1,
166       "total_tokens": 1,
167       "charged_credits": "string",
168       "call_count": 1,
169       "created": "string",
170       "modified": "string"
171     }
172   ],
173   "files": [
174     {
175       "original_filename": "contract.pdf",
176       "stored_filename": "b4a66744-6e99-4ad4-8aff-4d953bb0b9cf.pdf",
177       "content_type": "application/pdf",
178       "download_url": "/org/abc123.../project/def456.../task/ghi789.../run/jkl012.../file/b4a66744-6e99-4ad4-8aff-4d953bb0b9cf.pdf",
179       "size_bytes": 1024576,
180       "source": "input",
181       "source_task_name": "quote-image-generator",
182       "source_task_run_id": "019beb35-3976-e7da-4595-56338335cd5a"
183     }
184   ]
185 }

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

task_agent_revision_idstring or nullformat: "uuid"

adk_session_user_idstring or null

invocation_idstring or null

invocation_idslist of strings 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*$"

approval_request_idslist of strings

IDs of approval requests linked to this TaskAgentRun.

approval_requestslist of objects

Compact approval request summaries linked to this TaskAgentRun.

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

trigger_typestringDefaults 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 objects

fileslist of objectsDefaults 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