Get Project TaskAgent Timing Report

GET

/org/:org_id/project/:project_id/task-agent/timing_report

GET

/api/v1/org/:org_id/project/:project_id/task-agent/timing_report

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

1 {
2   "project_id": "0190a234-9876-5432-10ab-cdef01234567",
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_duration_ms": 0,
11       "total_runs": 0
12     },
13     "2026-07-24T09:00:00": {
14       "avg_duration_ms": 0,
15       "total_runs": 0
16     },
17     "2026-07-24T10:00:00": {
18       "avg_duration_ms": 7582,
19       "total_runs": 1
20     },
21     "2026-07-24T11:00:00": {
22       "avg_duration_ms": 0,
23       "total_runs": 0
24     }
25   },
26   "total_runs": 1
27 }

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

Scope the report with task_agent_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, and avg_duration_ms is the mean wall-clock duration of the runs in that bucket.

Aggregate timing across the TaskAgent runs visible to the caller in this project. Scope the report with `task_agent_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, and `avg_duration_ms` is the mean wall-clock duration of the runs in that bucket.

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 organization ID

project_idstringRequiredformat: "uuid"

The project ID

Query parameters

task_agent_idstring or nullOptionalformat: "uuid"

Filter to a specific TaskAgent

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 TaskAgent timing report details retrieved successfully

project_idstringformat: "uuid"

Unique identifier of the Project.

date_rangemap from strings to strings

Time period covered by the report.

aggregationenum

Time bucket granularity used for the report.

datamap from strings to objects

Average duration and visible run counts for each aggregation bucket.

total_runsinteger>=0

Total number of visible runs included in the report.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error