Get Session Detail

GET

/org/:org_id/project/:project_id/task-agent/:task_agent_id/session/:session_id

GET

/api/v1/org/:org_id/project/:project_id/task-agent/:task_agent_id/session/:session_id

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

1 {
2   "session_id": "019fa2da-4790-7718-8edc-ae551b239242",
3   "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
4   "run_count": 2,
5   "first_run": "2026-07-27T09:14:02Z",
6   "last_run": "2026-07-27T09:22:40Z",
7   "total_tokens": 3390,
8   "total_charged_credits": "6.15",
9   "runs": [
10     {
11       "id": "019fa2da-4790-712c-aaa2-cb8d287b620b",
12       "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
13       "session_id": "019fa2da-4790-7718-8edc-ae551b239242",
14       "user_id": "0190c234-1111-2222-3333-444444444444",
15       "input_tokens": 1840,
16       "output_tokens": 410,
17       "total_tokens": 2250,
18       "charged_credits": "4.10",
19       "created": "2026-07-27T09:14:02Z",
20       "completed": "2026-07-27T09:14:11Z",
21       "duration_ms": 9130,
22       "status": "completed",
23       "is_error": false,
24       "task_tools_invoked": [
25         {
26           "task_id": "019df7a2-44a0-7f6b-8a18-d81df57049d0",
27           "task_name": "Customer Support Analyzer",
28           "task_revision_id": "019df7a2-44a0-75d6-b036-4e86f6d45302",
29           "task_run_id": "019fa2da-4790-798a-9530-76940e914d17",
30           "is_error": false,
31           "is_formatter": false,
32           "duration_ms": 1120
33         },
34         {
35           "task_id": "019df7a2-44a0-7186-92a6-a8e45e78537b",
36           "task_name": "Draft Support Reply",
37           "task_revision_id": "019df7a2-44a0-78c4-ba7b-6ae382a6253a",
38           "task_run_id": "019fa2da-4790-7bff-bc7a-c397d193f25e",
39           "is_error": false,
40           "is_formatter": true,
41           "duration_ms": 2380
42         }
43       ],
44       "is_chaos_run": false,
45       "task_agent_revision_id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
46       "adk_session_user_id": "0190c234-1111-2222-3333-444444444444",
47       "invocation_id": "019fa2da-4790-7e73-b7af-bfd124a96ed6",
48       "invocation_ids": [
49         "019fa2da-4790-7e73-b7af-bfd124a96ed6"
50       ],
51       "is_continuation": false,
52       "primary_llm_model_id": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
53       "fallback_llm_model_id": "af2a9bbf-5f36-4b12-bd3f-92c57be96dec",
54       "used_fallback_model": false,
55       "total_charged_credits": "4.10",
56       "approval_request_ids": [],
57       "approval_requests": [],
58       "had_task_tool_fail": false,
59       "had_mcp_tool_fail": false,
60       "had_integration_tool_fail": false,
61       "integration_tools_invoked": [
62         {
63           "integration_id": "019df7a2-44a0-7a75-ae4f-4c8edcdac22e",
64           "integration_name": "Customer Database",
65           "integration_type": "google_sheets",
66           "integration_tool_id": "019df7a2-44a0-7b09-afd0-c59cbc20126d",
67           "tool_name": "sheets_spreadsheets_values_get",
68           "principal_type": "project_default",
69           "is_error": false,
70           "duration_ms": 640
71         }
72       ],
73       "phase_timings": [
74         {
75           "phase": "llm_inference",
76           "start_ms": 0,
77           "end_ms": 1450
78         },
79         {
80           "phase": "integration_tool_execution",
81           "start_ms": 1450,
82           "end_ms": 2090,
83           "call_id": "call-2b3c4d5e6f70",
84           "tool_name": "sheets_spreadsheets_values_get",
85           "integration_name": "Customer Database"
86         },
87         {
88           "phase": "task_tool_execution",
89           "start_ms": 2090,
90           "end_ms": 4470,
91           "call_id": "call-3c4d5e6f7081",
92           "task_run_id": "019fa2da-4790-7bff-bc7a-c397d193f25e"
93         }
94       ],
95       "context_usage": {
96         "estimator_version": "task_agent_context_usage_v1",
97         "input_tokens": {
98           "provider_total": 1840,
99           "observed_provider_total": 1840,
100           "estimated_total": 1890,
101           "uncategorized": 0,
102           "breakdown": {
103             "conversation_history": 0,
104             "current_user_message": 23,
105             "input_files": 0,
106             "instructions": 153,
107             "integrations": 0,
108             "mcp_tools": 0,
109             "registered_tools": 0,
110             "runtime_file": 108,
111             "skills": 0,
112             "task_tools": 20
113           }
114         },
115         "schema_version": 1,
116         "input_files": {
117           "estimated_tokens": 0,
118           "file_count": 0,
119           "text_file_count": 0,
120           "binary_file_count": 0,
121           "total_bytes": 0
122         },
123         "output_tokens": {
124           "provider_total": 410,
125           "observed_provider_total": 410
126         },
127         "runtime_components": {
128           "integrations": {
129             "estimated_tokens": 0,
130             "tool_declarations": {
131               "estimated_tokens": 0,
132               "count": 0,
133               "unavailable_count": 0,
134               "error_count": 0
135             },
136             "provenance": {}
137           },
138           "mcp_tools": {
139             "estimated_tokens": 0,
140             "tool_declarations": {
141               "estimated_tokens": 0,
142               "count": 0,
143               "unavailable_count": 0,
144               "error_count": 0
145             },
146             "provenance": {}
147           },
148           "registered_tools": {
149             "estimated_tokens": 0,
150             "tool_declarations": {
151               "estimated_tokens": 0,
152               "count": 0,
153               "unavailable_count": 0,
154               "error_count": 0
155             },
156             "provenance": {}
157           },
158           "runtime_file": {
159             "estimated_tokens": 108,
160             "tool_declarations": {
161               "estimated_tokens": 108,
162               "count": 1,
163               "unavailable_count": 0,
164               "error_count": 0
165             },
166             "provenance": {
167               "manual": 108
168             }
169           },
170           "skills": {
171             "estimated_tokens": 0,
172             "tool_declarations": {
173               "estimated_tokens": 0,
174               "count": 0,
175               "unavailable_count": 0,
176               "error_count": 0
177             },
178             "loaded_payloads": 0,
179             "provenance": {}
180           },
181           "task_tools": {
182             "estimated_tokens": 20,
183             "tool_declarations": {
184               "estimated_tokens": 20,
185               "count": 1,
186               "unavailable_count": 0,
187               "error_count": 0
188             },
189             "provenance": {
190               "manual": 20
191             }
192           }
193         },
194         "metadata": {
195           "request_count": 1,
196           "partial": false,
197           "provider_usage_missing": false,
198           "provider_usage_complete": true,
199           "observed_provider_total_tokens": 2250,
200           "estimation_truncated": false,
201           "truncated_estimate_count": 0,
202           "estimation_methods": [
203             "utf8_bytes_div_4"
204           ]
205         }
206       },
207       "last_activity_at": "2026-07-27T09:14:11Z",
208       "trigger_type": "api",
209       "model_usages": [
210         {
211           "id": "019fa2da-4790-7fa0-9552-00540687d1cb",
212           "task_agent_run_id": "019fa2da-4790-712c-aaa2-cb8d287b620b",
213           "llm_model_id": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
214           "usage_scope": "reasoning",
215           "usage_type": "primary",
216           "input_tokens": 1840,
217           "output_tokens": 410,
218           "total_tokens": 2250,
219           "charged_credits": "4.10",
220           "call_count": 3,
221           "created": "2026-07-27T09:14:02Z",
222           "modified": "2026-07-27T09:14:11Z"
223         }
224       ],
225       "files": []
226     },
227     {
228       "id": "019fa2e2-2f00-7be2-bcf0-f056f44f700a",
229       "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
230       "session_id": "019fa2da-4790-7718-8edc-ae551b239242",
231       "user_id": "0190c234-1111-2222-3333-444444444444",
232       "input_tokens": 960,
233       "output_tokens": 180,
234       "total_tokens": 1140,
235       "charged_credits": "2.05",
236       "created": "2026-07-27T09:22:40Z",
237       "completed": "2026-07-27T09:24:20Z",
238       "duration_ms": 100000,
239       "status": "completed",
240       "is_error": false,
241       "task_tools_invoked": [
242         {
243           "task_id": "019df7a2-44a0-7186-92a6-a8e45e78537b",
244           "task_name": "Draft Support Reply",
245           "task_revision_id": "019df7a2-44a0-78c4-ba7b-6ae382a6253a",
246           "task_run_id": "019fa2e2-2f00-7f38-a32e-85d18e953d52",
247           "is_error": false,
248           "is_formatter": true,
249           "duration_ms": 1360
250         }
251       ],
252       "is_chaos_run": false,
253       "task_agent_revision_id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
254       "adk_session_user_id": "0190c234-1111-2222-3333-444444444444",
255       "invocation_id": "019fa2e2-2f00-7a54-9f70-cd49ad3571d2",
256       "invocation_ids": [
257         "019fa2e2-2f00-7a54-9f70-cd49ad3571d2"
258       ],
259       "is_continuation": true,
260       "primary_llm_model_id": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
261       "fallback_llm_model_id": "af2a9bbf-5f36-4b12-bd3f-92c57be96dec",
262       "used_fallback_model": false,
263       "total_charged_credits": "2.05",
264       "approval_request_ids": [
265         "019fa2e2-2f00-71c7-aee7-539ab31cd302"
266       ],
267       "approval_requests": [
268         {
269           "id": "019fa2e2-2f00-71c7-aee7-539ab31cd302",
270           "status": "approved",
271           "tool_type": "integration",
272           "tool_name": "sheets_spreadsheets_values_append",
273           "requested_at": "2026-07-27T09:22:41Z",
274           "decided_at": "2026-07-27T09:24:15Z",
275           "requested_by_user_id": "0190c234-1111-2222-3333-444444444444",
276           "decided_by_user_id": "019df7a2-44a0-7f54-8478-e19c351d1cc8",
277           "decision_note": "Approved — logging the resolved ticket is fine."
278         }
279       ],
280       "had_task_tool_fail": false,
281       "had_mcp_tool_fail": false,
282       "had_integration_tool_fail": false,
283       "integration_tools_invoked": [
284         {
285           "integration_id": "019df7a2-44a0-7a75-ae4f-4c8edcdac22e",
286           "integration_name": "Customer Database",
287           "integration_type": "google_sheets",
288           "integration_tool_id": "019df7a2-44a0-7923-9ea9-87be4ba93be9",
289           "tool_name": "sheets_spreadsheets_values_append",
290           "principal_type": "project_default",
291           "is_error": false,
292           "duration_ms": 510
293         }
294       ],
295       "last_activity_at": "2026-07-27T09:24:20Z",
296       "trigger_type": "api",
297       "model_usages": [
298         {
299           "id": "019fa2e2-2f00-76c3-8b69-2a582554fe03",
300           "task_agent_run_id": "019fa2e2-2f00-7be2-bcf0-f056f44f700a",
301           "llm_model_id": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
302           "usage_scope": "reasoning",
303           "usage_type": "primary",
304           "input_tokens": 960,
305           "output_tokens": 180,
306           "total_tokens": 1140,
307           "charged_credits": "2.05",
308           "call_count": 2,
309           "created": "2026-07-27T09:22:40Z",
310           "modified": "2026-07-27T09:24:20Z"
311         }
312       ],
313       "files": []
314     }
315   ]
316 }

Get detailed information about a specific session.

Returns session summary (run count, tokens) plus individual runs, including phase timing data 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 unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

task_agent_idstringRequiredformat: "uuid"

The specific Task Agent to reference.

session_idstringRequired

The session ID (UUID format, server-generated).

Response

Session detail

session_idstring

ADK session ID (string format).

task_agent_idstringformat: "uuid"

run_countinteger

Number of runs in this session.

first_runstring

last_runstring

total_tokensinteger

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

Sum of total_charged_credits across all runs in this session.

runslist of objectsOptionalDefaults to []

Runs in this session.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error