List Task Agent Sessions

GET

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

GET

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

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

1 [
2   {
3     "session_id": "019fa2da-4790-7718-8edc-ae551b239242",
4     "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
5     "run_count": 2,
6     "first_run": "2026-07-27T09:14:02Z",
7     "last_run": "2026-07-27T09:22:40Z",
8     "total_tokens": 3390,
9     "total_charged_credits": "6.15"
10   },
11   {
12     "session_id": "019f7fd8-26e0-7bde-a9b4-b22262209480",
13     "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
14     "run_count": 1,
15     "first_run": "2026-07-20T14:05:00Z",
16     "last_run": "2026-07-20T14:05:00Z",
17     "total_tokens": 1410,
18     "total_charged_credits": "2.35"
19   }
20 ]

List conversation sessions for a Task Agent.

Sessions group related runs together for multi-turn conversations.

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.

Response

Session list

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.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error