List Project Recent Task Runs By Task

GET

/org/:org_id/project/:project_id/task_run/recent_by_task

GET

/api/v1/org/:org_id/project/:project_id/task_run/recent_by_task

$ curl https://app.rightbrain.ai/api/v1/org/123e4567-e89b-12d3-a456-426614174000/project/123e4567-e89b-12d3-a456-426614174001/task_run/recent_by_task \
>      -H "Authorization: Bearer <token>"

1 {
2   "results": [
3     {
4       "task_id": "019011e6-e530-3aca-6cf7-2973387c255d",
5       "task_name": "Example Task",
6       "recent_runs": [
7         {
8           "id": "019097c5-5560-05b5-4a48-5197a269683b",
9           "status": "success",
10           "created": "2026-02-12T12:00:00+00:00"
11         }
12       ]
13     },
14     {
15       "task_id": "019011e6-e530-3aca-6cf7-2973387c255e",
16       "task_name": "Task With No Visible Runs",
17       "recent_runs": []
18     }
19   ],
20   "pagination": {
21     "next_cursor": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
22     "has_next": true,
23     "page_limit": 25
24   }
25 }

List visible tasks in a project with recent visible task runs nested under each task.

This endpoint paginates tasks, not task runs. Each task includes up to runs_per_task recent runs visible to the requesting user, ordered newest first. Tasks with no visible runs are still included with an empty recent_runs array.

Visibility follows the same task-run visibility rules used by the project task-run list: users may see all runs for some tasks, only their own runs for others, or no runs at all while still being able to view the task itself.

List visible tasks in a project with recent visible task runs nested under each task. This endpoint paginates tasks, not task runs. Each task includes up to `runs_per_task` recent runs visible to the requesting user, ordered newest first. Tasks with no visible runs are still included with an empty `recent_runs` array. Visibility follows the same task-run visibility rules used by the project task-run list: users may see all runs for some tasks, only their own runs for others, or no runs at all while still being able to view the task itself.

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.

Query parameters

page_limitintegerOptional1-100Defaults to 100

Maximum number of tasks to return per page.

cursorstringOptional

Pagination cursor for the next page of tasks.

runs_per_taskintegerOptional1-50Defaults to 30

Maximum number of recent visible task runs to include for each task.

Response

Paginated list of tasks with recent visible task runs.

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