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