Sign in
agent-telemetry

Agent Telemetry Series

Changed on

Row volume over time, split by user or API key (standalone).

Mirrors /api/v1/usage/series: same window bounds and bucket-grid cap, the top groups as their own series with the remainder folded into a reconciling other, and sparse points (populated cells only). Counts rows, not spend, so it charts telemetry volume rather than cost. Master-key only.

get/api/v1/agent-telemetry/series

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header Otari-Key
    • API key in header x-api-key

Query parameters

group_by'user_id' | 'api_key_id' required

Dimension to split the series by

start_datestring date-time nullable

Return rows with timestamp >= start_date (ISO 8601 or Unix epoch seconds)

end_datestring date-time nullable

Return rows with timestamp < end_date (ISO 8601 or Unix epoch seconds)

user_idstring[] nullable

Filter to one or more users; repeatable (user_id=a&user_id=b). Several values match any of them. At most 50 per call.

api_key_idstring[] nullable

Filter to one or more API key ids; repeatable (api_key_id=a&api_key_id=b). Several values match any of them. At most 50 per call.

namestring nullable

Filter to a single event type or metric name (e.g. 'tool_result', 'claude_code.commit.count')

bucket'hour' | 'day'

Time-series granularity: 'hour' or 'day'

Response

Successful Response

bucket'hour' | 'day' required
end_datestring required
group_by'user_id' | 'api_key_id' required
start_datestring required

Changes

  • fbee488d4d9fRevision changes
    • info

      added the optional property to the response with the status

  • e27406481fffRevision changes
    • info

      api operation id agent_telemetry_series_api_v1_agent_telemetry_series_get removed and replaced with agent-telemetry-agent_telemetry_series