Fetch Timing Report

GET

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

GET

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

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

1 {
2   "task_id": "0190a234-8dc6-6d08-aea9-928fcecad8f1",
3   "date_range": {
4     "end": "2024-03-15T15:00:00Z",
5     "start": "2024-03-14T15:00:00Z"
6   },
7   "aggregation": "hour",
8   "total_task_runs": {
9     "2024-03-14 15:00:00": 150,
10     "2024-03-14 16:00:00": 165
11   },
12   "task_revisions": [
13     {
14       "task_revision_id": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
15       "data": {
16         "2024-03-14 15:00:00": {
17           "avg_llm_call_timing": 2.45,
18           "total_task_runs": 150
19         },
20         "2024-03-14 16:00:00": {
21           "avg_llm_call_timing": 2.38,
22           "total_task_runs": 165
23         }
24       }
25     }
26   ]
27 }

Retrieve average LLM call timing for task executions over time.

This endpoint returns:

Average llm_call_timing values grouped by hour or day
Total task run counts for each time bucket
A per-revision breakdown, including test revisions

Defaults:

aggregation=hour returns the last 24 hours when no date range is provided
aggregation=day returns the last 7 days when no date range is provided

Retrieve average LLM call timing for task executions over time. This endpoint returns: - Average `llm_call_timing` values grouped by hour or day - Total task run counts for each time bucket - A per-revision breakdown, including test revisions Defaults: - `aggregation=hour` returns the last 24 hours when no date range is provided - `aggregation=day` returns the last 7 days when no date range is provided

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

start_datestring or nullOptional

Start date for the report (e.g., ‘2023-06-01’, ‘24 hours ago’, ‘yesterday’).

end_datestring or nullOptional

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

aggregationenumOptionalDefaults to hour

The aggregation level for the report. Can be either 'hour' or 'day'

Allowed values:

Response

Timing report retrieved successfully

task_idstringformat: "uuid"

The unique identifier of the Task.

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. 'hour' shows last 24 hours in hourly blocks, 'day' shows last 7 days in daily blocks.

total_task_runsmap from strings to integers

Total number of task runs for each time interval.

task_revisionslist of objects

Timing data broken down by task revision, showing performance metrics for each active revision.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error