Get Project Task Timing Report

GET

/org/:org_id/project/:project_id/task_run/timing_report

GET

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

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

1 {
2   "project_id": "019f6b10-2e8a-7c91-9a3d-6e0f8b2c1d47",
3   "date_range": {
4     "end": "2026-07-24T11:00:00Z",
5     "start": "2026-07-24T08:00:00Z"
6   },
7   "aggregation": "hour",
8   "data": {
9     "2026-07-24T08:00:00": {
10       "avg_llm_call_timing": 0,
11       "total_task_runs": 0
12     },
13     "2026-07-24T09:00:00": {
14       "avg_llm_call_timing": 0,
15       "total_task_runs": 0
16     },
17     "2026-07-24T10:00:00": {
18       "avg_llm_call_timing": 2.6357791689988517,
19       "total_task_runs": 1
20     },
21     "2026-07-24T11:00:00": {
22       "avg_llm_call_timing": 0,
23       "total_task_runs": 0
24     }
25   },
26   "total_task_runs": 1
27 }

Aggregate timing across the Task runs visible to the caller in this project.

Scope the report with task_id, start_date and end_date. aggregation selects the bucket granularity: hour (the default) covers the last 24 hours, day the last seven days.

data contains every bucket in the window, including empty ones.

Aggregate timing across the Task runs visible to the caller in this project. Scope the report with `task_id`, `start_date` and `end_date`. `aggregation` selects the bucket granularity: `hour` (the default) covers the last 24 hours, `day` the last seven days. `data` contains every bucket in the window, including empty ones.

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.

Query parameters

task_idstring or nullOptionalformat: "uuid"

Filter to a specific task

start_datedatetime or nullOptional

Report start timestamp

end_datedatetime or nullOptional

Report end timestamp

aggregationenumOptionalDefaults to hour

Time bucket granularity. Can be either 'hour' or 'day'.

Allowed values:

Response

Project Task timing report details retrieved successfully

project_idstringformat: "uuid"

The unique identifier of the Project.

date_rangemap from strings to nullable strings

The time range for the report, with start and end timestamps.

aggregationenum

The time interval for data aggregation.

datamap from strings to objects

Timing data for each time bucket.

total_task_runsinteger

Total visible task runs across the full reporting window.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error