TasksGA

Fetch Timing Report

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

Path parameters

org_idstringRequired

The unique identifier of the organization.

project_idstringRequired

The unique identifier of the project.

task_idstringRequired

The specific Task to reference.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

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 ‘day’ or ‘week’.

Allowed values:

Response

Successful Response

task_idstringformat: "uuid"

The unique identifier of the Task.

date_rangemap from strings to optional 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