List usage events
GET/api/v1/usage/events
Returns the raw usage events the caller can access, most recent first, narrowed by any combination of the same filters the aggregate takes — agent, generation, trace, actor, session, AI provider, orchestration run, orchestration, trigger, action, meter type, model or source — so a rollup and the events behind it are addressed the same way. Each event is the per-generation token usage as reported by the provider, for audit and reconciliation.
An id naming nothing in scope yields an empty page rather than dropping the filter, so a mistyped narrowing can never widen the list past what was asked for.
Request
Responses
- 200
- 400
- 401
- 403
Paginated list of usage events
Bad Request — a query parameter this endpoint does not declare. An unrecognised filter is rejected rather than ignored, since ignoring one answers a narrow question with the unfiltered list.
Unauthorized
Forbidden