OpenAPI 3.1.0raw.githubusercontent.com2026-08-13100124426.6 KB

3f47ecc61aff

agent-telemetry

Count Agent Telemetry

Total agent_telemetry rows matching the given filters (standalone).

The filter set mirrors the purge endpoint's, so this sizes exactly what a "delete all N matching" would remove. Behavioral and metric rows are counted together: neither this nor the purge distinguishes them. Master-key only.

get/v1/agent-telemetry/count

Query parameters

start_datestring date-time nullable

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

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)

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.

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.

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')

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

Response

Successful Response

totalinteger required