Usage - AUI

Usage endpoints report metrics — interaction counts and token volume — for one agent or aggregated across a project, over a time window you choose.

Get usage

cURL

curl "https://api-v3.aui.io/apollo-api/management/v1/agents/{agentId}/usage?created_from=2026-07-01T00:00:00Z&created_to=2026-07-13T00:00:00Z" \
  -H "x-organization-api-key: <org_api_key>"

GET `/management/v1/agents/{agentId}/usage`

GET `/management/v1/projects/{projectId}/usage`

Same parameters and response for both — the project variant aggregates across every agent in the project.

Query parameters

created_from

string

Start of the usage window (RFC 3339). Omit for no lower bound.

created_to

string

End of the usage window (RFC 3339). Omit for no upper bound.

Response

interaction_count

integer

Number of interactions in the window.

input_tokens

integer

Total input tokens.

output_tokens

integer

Total output tokens.

cache_read_tokens

integer

Total cached (read) input tokens.

reasoning_tokens

integer

Total reasoning tokens.

total_tokens

integer

Sum of input, output, cache-read, and reasoning tokens.

{
  "interaction_count": 1284,
  "input_tokens": 512400,
  "output_tokens": 98211,
  "cache_read_tokens": 240100,
  "reasoning_tokens": 15320,
  "total_tokens": 866031
}

​Get usage

​GET /management/v1/agents/{agentId}/usage

​GET /management/v1/projects/{projectId}/usage

​Query parameters

​Response

Get usage

GET `/management/v1/agents/{agentId}/usage`

GET `/management/v1/projects/{projectId}/usage`

Query parameters

Response