Get an agent's usage
Returns invocation metrics for the agent over the half-open [from, to)
time range (UTC), bucketed at the requested granularity. The response
echoes the resolved range and granularity, a totals summary across the
whole range, and one buckets entry per period that had activity (the
array is empty when there was none). When from/to are omitted, the
range defaults to the last 30 days.
Authorizations
OAuth 2.0 / OIDC bearer token.
The tenant the request operates within.
Path Parameters
Agent identifier (prefixed UUIDv7).
Agent identifier. Accepts agt.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.
^(agt\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"
Query Parameters
Inclusive start of the range, as an RFC 3339 timestamp (UTC).
Defaults to 30 days before to. Must not be after to.
Exclusive end of the range, as an RFC 3339 timestamp (UTC). Defaults to the current time.
Size of each reporting bucket. Defaults to day.
The size of each usage reporting bucket. Only day is currently honored; minute, hour, and week are accepted but produce daily buckets (the server always returns day).
minute, hour, day, week Response
The agent's bucketed usage over the requested range.
An agent's bucketed usage over a date range, with range-wide totals.
The size of each usage reporting bucket. Only day is currently honored; minute, hour, and week are accepted but produce daily buckets (the server always returns day).
minute, hour, day, week Resolved inclusive start of the range (UTC).
"2026-05-19T00:00:00Z"
Resolved exclusive end of the range (UTC).
"2026-05-21T00:00:00Z"
Aggregate metrics across the whole range.
One entry per period with activity, ordered oldest first.