Tasks

Fetch Usage Report

GA

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

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

aggregationenumOptionalDefaults to day
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 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