API ReferenceTask Agents

Fetch Task Agent Token Report

Retrieve aggregate reasoning token usage for a specific Task Agent. This report includes: - Total input tokens across all agent runs - Total output tokens across all agent runs - Combined reasoning token usage - Number of runs included in the report Filters: - `start_date`: Include runs created on or after this date - `end_date`: Include runs created on or before this date Date parameters support both absolute and relative formats such as: - `2024-01-15` - `now` - `24 hours ago` - `yesterday`

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

org_idstringRequiredformat: "uuid"
The organization ID
project_idstringRequiredformat: "uuid"
The project ID
task_agent_idstringRequiredformat: "uuid"
The task agent ID

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

Task Agent token report
task_agent_idstringformat: "uuid"
Unique identifier of the TaskAgent.
date_rangemap from strings to strings
Time period covered by the report.
total_input_tokensinteger>=0
Total input tokens consumed by agent reasoning during the reporting period.
total_output_tokensinteger>=0
Total output tokens produced by agent reasoning during the reporting period.
total_tokensinteger>=0
Combined total of input and output tokens during the reporting period.
total_runsinteger>=0
Number of TaskAgent runs included in the report.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error