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/123e4567-e89b-12d3-a456-426614174000/project/123e4567-e89b-12d3-a456-426614174001/task-agent/01909843-3596-da54-4756-28af46917e74/session/01909843-3596-da54-4756-28af46917e74 \
>      -H "Authorization: Bearer <token>"

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

Get detailed information about a specific session.

Returns session summary (run count, tokens) plus individual runs, including phase timing data when available.

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

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