API ReferenceTasks

Fetch Usage Report

Retrieve usage statistics for task executions. This endpoint provides detailed usage data about task runs, including: - Number of executions over time - Success and failure rates - Usage patterns by time period - Aggregated metrics by day or week Use this data to: 1. Monitor task usage patterns 2. Track execution success rates 3. Analyze usage trends 4. Plan capacity and scaling

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

aggregationenumOptionalDefaults to day
The aggregation level for the report. Can be either 'day' or 'week'.
Allowed values:
errors_onlybooleanOptionalDefaults to false
If true, only include invocations with errors in the report.

Response

Usage report retrieved successfully
task_idstringformat: "uuid"
The unique identifier of the Task.
date_rangemap from strings to any
The time range for the report, with start and end timestamps.
aggregationenum
The time interval for data aggregation. 'day' shows last 24 hours in hourly blocks, 'week' shows last 7 days in daily blocks.
Allowed values:
task_revisionslist of objects
Usage data broken down by task revision, showing invocation counts for each active revision.
total_countsmap from strings to integers
Total number of task invocations for each time interval across all revisions.

Errors