Skip to main content
POST
Usage summary for the caller's visible scope (self, team, or org by role): totals, top models, active users, spend leaderboard

Authorizations

Authorization
string
header
required

A management token: minted by the OAuth flow (aireserve login, or an MCP client's Authenticate step) or on the portal Keys page under Management Keys. Inference API keys are refused.

Body

application/json
days

Trailing window in days: 1, 7, or 30 (default 7)

Available options:
1
view
enum<string>

"me" restricts to the caller's own usage; default is the widest scope their role may see

Available options:
default,
me
teamName
string

Admin/team-lead drill-down: narrow to one team (and its sub-teams) by name

Required string length: 1 - 200
memberEmail
string

Admin/team-lead drill-down: narrow to a single member by email

Required string length: 1 - 320

Response

Executed successfully (ok: true).

status
enum<string>
required
Available options:
executed
ok
boolean
required

Whether the operation succeeded.

summary
string
required

The consent line describing what was done, built from resolved labels.

message
string
required

Human-readable result line.

data
any

Operation payload (reads) or detail worth relaying (writes).

secret
string

A one-time secret the operation minted (API key, credential). Shown once; store it now.

sensitive
enum<boolean>

Present exactly when secret is: redact this response from logs.

Available options:
true