List Task Runs

GET

/org/:org_id/project/:project_id/task/:task_id/run

GET

/api/v1/org/:org_id/project/:project_id/task/:task_id/run

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

1 {
2   "results": [
3     {
4       "task_id": "019f8a00-1c3d-7e42-b8f1-2a5c9d4e7b60",
5       "task_revision_id": "019f8a01-4b3d-7e52-9c02-3b6d8f1a5c71",
6       "response": {
7         "category": "technical",
8         "priority": "urgent",
9         "summary": "API integration is returning 500 errors on all webhook deliveries since this morning."
10       },
11       "run_data": {
12         "submitted": {
13           "body": "All our webhook deliveries have been failing with a 500 error since 9am. This is blocking our production sync.",
14           "plan": "Enterprise",
15           "subject": "Webhooks failing with 500"
16         },
17         "integration_tool_calls": [],
18         "mcp_tool_calls": []
19       },
20       "id": "019f8a05-9f71-7c96-b048-7fa0c25f9ab5",
21       "created": "2026-07-24T11:47:03Z",
22       "input_tokens": 201,
23       "output_tokens": 47,
24       "total_tokens": 248,
25       "input_processor_timing": 0.0001671,
26       "llm_call_timing": 2.91,
27       "charged_credits": "1.35",
28       "model_name": "claude-sonnet-5",
29       "task_name": "Support Ticket Triage",
30       "output_modality": "json",
31       "files": [],
32       "is_error": false,
33       "llm_retries": 1,
34       "used_fallback_model": true,
35       "primary_failure_reason": "Primary model rate limited (429)",
36       "fallback_llm_model_id": "019f6a01-0f4e-7d53-9a2c-6b7d8e9fa102",
37       "user_id": "019f6c10-1a2b-7c3d-8e4f-5a6b7c8d9e01",
38       "input_processor_charged_credits": "0.00"
39     },
40     {
41       "task_id": "019f8a00-1c3d-7e42-b8f1-2a5c9d4e7b60",
42       "task_revision_id": "019f8a01-4b3d-7e52-9c02-3b6d8f1a5c71",
43       "response": {
44         "category": "billing",
45         "priority": "high",
46         "summary": "Customer was double-charged for their Pro plan renewal and wants a refund."
47       },
48       "run_data": {
49         "submitted": {
50           "body": "I was billed twice for my Pro subscription on the 3rd and the 5th. Please refund the duplicate charge.",
51           "plan": "Pro",
52           "subject": "Charged twice this month"
53         },
54         "integration_tool_calls": [],
55         "mcp_tool_calls": []
56       },
57       "id": "019f8a04-8e60-7b85-af37-6e9fb14d8fa4",
58       "created": "2026-07-24T10:02:17Z",
59       "input_tokens": 186,
60       "output_tokens": 42,
61       "total_tokens": 228,
62       "input_processor_timing": 0.00015282,
63       "llm_call_timing": 1.346,
64       "charged_credits": "1.00",
65       "model_name": "claude-sonnet-5",
66       "task_name": "Support Ticket Triage",
67       "output_modality": "json",
68       "files": [],
69       "is_error": false,
70       "llm_retries": 0,
71       "used_fallback_model": false,
72       "user_id": "019f6c10-1a2b-7c3d-8e4f-5a6b7c8d9e01",
73       "input_processor_charged_credits": "0.00"
74     }
75   ],
76   "pagination": {
77     "next_cursor": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
78     "has_next": true,
79     "page_limit": 25
80   }
81 }

Retrieve a paginated list of task runs for a specific task.

Task runs provide an audit trail of all task executions, including:

Input parameters used
Execution status and timing
Resource usage metrics (tokens, credits)
Output results
Error information for failed runs
Fallback model usage information

This endpoint supports:

Pagination using cursor-based navigation
Filtering by a created-time date range
Filtering by task revision
Filtering by status (success/error)
Sorting by creation time (newest first)

Common use cases:

Monitoring task execution history
Auditing task usage and performance
Debugging task behavior across multiple runs
Analyzing task output patterns
Tracking fallback model usage and reliability

Retrieve a paginated list of task runs for a specific task. Task runs provide an audit trail of all task executions, including: - Input parameters used - Execution status and timing - Resource usage metrics (tokens, credits) - Output results - Error information for failed runs - Fallback model usage information This endpoint supports: - Pagination using cursor-based navigation - Filtering by a created-time date range - Filtering by task revision - Filtering by status (success/error) - Sorting by creation time (newest first) Common use cases: 1. Monitoring task execution history 2. Auditing task usage and performance 3. Debugging task behavior across multiple runs 4. Analyzing task output patterns 5. Tracking fallback model usage and reliability

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_idstringRequiredformat: "uuid"

The specific Task to reference.

Query parameters

page_limitinteger or nullOptional1-100Defaults to 100

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

cursorstring or nullOptionalformat: "uuid"

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

statusenum or nullOptional

Filter by task run status

Allowed values:

task_revision_idstring or nullOptionalformat: "uuid"

Filter task runs by revision ID

start_datestring or nullOptional

Start date for the listing (e.g., ‘2023-06-01’, ‘24 hours ago’, ‘yesterday’). Defaults to 7 days before end_date or now.

end_datestring or nullOptional

End date for the listing (e.g., ‘2023-06-30’, ‘now’, ‘today’). Defaults to now.

include_event_trigger_idbooleanOptionalDefaults to false

If true, include event_trigger_id for each task run in results.

Response

Successfully retrieved task runs

resultslist of objects

The list of items returned for the current page.

paginationobject or nullOptional

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