Fetch Timing Report | Rightbrain Docs | Transform AI Ideas into Production Tasks

curl https://app.rightbrain.ai/api/v1/org/123e4567-e89b-12d3-a456-426614174000/project/123e4567-e89b-12d3-a456-426614174001/task/01909843-3596-da54-4756-28af46917e74/timing_report \
     -H "Authorization: Bearer <token>"

{
  "task_id": "0190a234-8dc6-6d08-aea9-928fcecad8f1",
  "date_range": {},
  "aggregation": "day",
  "total_task_runs": {},
  "task_revisions": [
    {
      "task_revision_id": "string",
      "data": {}
    }
  ],
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "total_runs": 156,
  "successful_runs": 148,
  "failed_runs": 8,
  "average_duration_ms": 2340,
  "min_duration_ms": 980,
  "max_duration_ms": 8500,
  "percentile_95_duration_ms": 4200,
  "data_points": [
    {
      "timestamp": "2024-01-15T00:00:00Z",
      "run_count": 12,
      "average_duration_ms": 2150,
      "successful_count": 11,
      "failed_count": 1
    },
    {
      "timestamp": "2024-01-16T00:00:00Z",
      "run_count": 15,
      "average_duration_ms": 2380,
      "successful_count": 15,
      "failed_count": 0
    }
  ]
}

Retrieve timing metrics for task executions.

This endpoint provides detailed timing data about task runs, including:

Average response times
Processing durations
LLM call latencies
Aggregated metrics by hour or day

Use this data to:

Monitor task performance
Identify performance bottlenecks
Track timing trends over time
Optimize task configurations

Retrieve timing metrics for task executions. This endpoint provides detailed timing data about task runs, including: - Average response times - Processing durations - LLM call latencies - Aggregated metrics by hour or day Use this data to: 1. Monitor task performance 2. Identify performance bottlenecks 3. Track timing trends over time 4. Optimize task configurations

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.

task_idstringRequiredformat: "uuid"

The specific Task to reference.

Query parameters

start_datestringOptional

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

end_datestringOptional

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 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.

Allowed values:

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