Get Run Events

GET

/org/:org_id/project/:project_id/task-agent/:task_agent_id/run/:run_id/events

GET

/api/v1/org/:org_id/project/:project_id/task-agent/:task_agent_id/run/:run_id/events

$ 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/run/01909843-3596-da54-4756-28af46917e74/events \
>      -H "Authorization: Bearer <token>"

1 {
2   "run_id": "string",
3   "session_id": "string",
4   "events": [
5     {
6       "id": "string",
7       "author": "user",
8       "timestamp": "2024-01-15T09:30:00Z",
9       "event_type": "user_message",
10       "content": "string",
11       "tool_calls": [
12         {
13           "name": "string",
14           "args": {}
15         }
16       ],
17       "tool_results": [
18         {
19           "name": "string",
20           "tool_result_type": "task",
21           "task_run_id": "string",
22           "mcp_server_name": "string",
23           "is_formatter_output": false,
24           "result": {}
25         }
26       ],
27       "files": [
28         {
29           "original_filename": "contract.pdf",
30           "stored_filename": "b4a66744-6e99-4ad4-8aff-4d953bb0b9cf.pdf",
31           "content_type": "application/pdf",
32           "download_url": "/org/abc123.../project/def456.../task/ghi789.../run/jkl012.../file/b4a66744-6e99-4ad4-8aff-4d953bb0b9cf.pdf",
33           "size_bytes": 1024576,
34           "source": "input",
35           "source_task_name": "quote-image-generator",
36           "source_task_run_id": "019beb35-3976-e7da-4595-56338335cd5a"
37         }
38       ],
39       "error_message": "string",
40       "metadata": {}
41     }
42   ]
43 }

Get conversation events for a specific TaskAgentRun.

Returns the full conversation history from the ADK session including:

User messages
Agent responses
Tool calls and results
Metadata-only memory compaction events, including token-threshold metadata when token-aware compaction was active
Error messages (if any)

Events are returned in chronological order.

Get conversation events for a specific TaskAgentRun. Returns the full conversation history from the ADK session including: - User messages - Agent responses - Tool calls and results - Metadata-only memory compaction events, including token-threshold metadata when token-aware compaction was active - Error messages (if any) Events are returned in chronological order.

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.

run_idstringRequiredformat: "uuid"

The specific Run to reference.

Query parameters

include_historybooleanOptionalDefaults to false

Include full session history, not just this run's events

Response

Run events

run_idstringformat: "uuid"

ID of the TaskAgentRun.

session_idstring

ADK session ID.

eventslist of objects

Conversation events from the session.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error