List Task Agent Runs

GET

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

GET

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

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

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

List execution runs for a Task Agent.

Returns run history with:

Input message
Token usage
Status and duration
Task tools invoked
MCP tools invoked
Phase timings for LLM, tool execution, and memory compaction when applicable

List execution runs for a Task Agent. Returns run history with: - Input message - Token usage - Status and duration - Task tools invoked - MCP tools invoked - Phase timings for LLM, tool execution, and memory compaction when applicable

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

task_agent_idstringRequiredformat: "uuid"

The task agent ID

Query parameters

session_idstringOptional

Filter by session ID

is_errorbooleanOptional

Filter by run-level error status.

had_task_tool_failbooleanOptional

Filter by whether any invoked task tool failed.

had_mcp_tool_failbooleanOptional

Filter by whether any invoked MCP tool failed.

statusenumOptional

Filter by run status.

Allowed values:

created_afterstringOptionalformat: "date-time"

Filter runs created at/after this timestamp.

created_beforestringOptionalformat: "date-time"

Filter runs created at/before this timestamp.

min_duration_msintegerOptional>=0

Filter runs with duration greater than or equal to this value.

task_agent_revision_idstringOptionalformat: "uuid"

Filter by TaskAgent revision ID.

page_limitintegerOptional1-100Defaults to 100

The maximum number of items to return per page. Defaults to 100 if not specified.

cursorstringOptional

A cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

Response

Run history

resultslist of objects

The list of items returned for the current page.

paginationobject or null

Contains pagination information for the result set.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error