Tasks

Fetch Token Report

GA

Retrieve detailed token usage statistics for a specific task.

This endpoint provides comprehensive token consumption data, including:

  • Total tokens used across all task runs
  • Token usage breakdown by time period
  • Average tokens per request
  • Usage patterns and trends

Parameters:

  • start_date: Filter data from this date onward (supports both absolute dates and relative times)
  • end_date: Filter data up to this date (supports both absolute dates and relative times)

Date Format Options:

  1. Absolute dates: ‘YYYY-MM-DD’ (e.g., ‘2024-01-15’)
  2. Relative times:
    • ‘now’, ‘today’, ‘yesterday’
    • ‘X hours/days/weeks ago’ (e.g., ‘24 hours ago’, ‘7 days ago’)
    • ‘last week’, ‘last month’

Common Use Cases:

  1. Monitoring token consumption trends
  2. Cost analysis and budgeting
  3. Usage pattern analysis
  4. Resource allocation planning

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

Response

Successfully retrieved token usage report

task_idstringformat: "uuid"

Unique identifier of the task

date_rangemap from strings to optional strings

Time period covered by the report, with start and end timestamps

total_input_tokensinteger>=0

Total number of input tokens consumed across all revisions and runs

total_output_tokensinteger>=0

Total number of output tokens generated across all revisions and runs

total_tokensinteger>=0

Combined total of input and output tokens across all revisions

total_task_runsinteger>=0

Total number of task executions across all revisions

task_revisionslist of objects

Token usage breakdown by task revision, showing detailed statistics for each active revision

Errors