Create a token usage report

Creates a new token usage report request. Returns immediately with report metadata
(status: pending). Report generation happens asynchronously via background worker.

Subscribe to WebSocket channel workspace:{workspace_id} to receive
token_report:updated events when the report completes.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
Body Params

TokenReports.CreateReportRequest

Request to create an agent token usage report

boolean
Defaults to false

When true, the report is omitted from list endpoints and deleted after one day.

filters
object

Filters for agent reports

date-time
required

DateTime in RFC3339 format

string
enum
required

Time granularity for aggregation.

  • hourly: Max 3 days date range
  • daily: Max 1 month date range
  • weekly: Max 3 months date range
  • monthly: Max 3 months date range
Allowed:
group_by
array of objects

Dimensions to group by. Default: [model]

group_by
string
enum
required
Allowed:
date-time
required

DateTime in RFC3339 format

Responses

Callback
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json