Get project usage
Usage metrics aggregated across every agent in the project, optionally bounded by a date range.
Authorizations
Access token from POST /management/v1/auth/token (publishable-key exchange) or a login session. Publishable-key tokens are agent-scoped and serve the messaging surface; login tokens also serve management.
Path Parameters
^[0-9a-fA-F]{24}$Query Parameters
Start of the usage window (RFC 3339). Maps to created>=.
End of the usage window (RFC 3339). Maps to created<=.
Response
Successful Response
Usage metrics for one agent or across a project over the requested window.
Number of billed interactions (one per interaction).
Total input tokens.
Total output tokens.
Total cached (read) input tokens.
Total reasoning tokens.
Sum of input + output + cache-read + reasoning tokens.