Get aggregate usage stats for an agent
GET /v1/agents/{agent_id}/stats
GET
/v1/agents/{agent_id}/stats
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” agent_id
required
string
Agent ID (prefixed) or name
Responses
Section titled “ Responses ”Agent aggregate stats
object
active_session_count
required
integer format: int64
avg_session_duration_ms
integer | null format: int64
execution_count
required
integer format: int64
first_session_at
string | null format: date-time
idle_session_count
required
integer format: int64
last_execution_at
string | null format: date-time
last_session_at
string | null format: date-time
session_count
required
integer format: int64
started_session_count
required
integer format: int64
total_cache_creation_tokens
required
integer format: int64
total_cache_read_tokens
required
integer format: int64
total_input_tokens
required
integer format: int64
total_output_tokens
required
integer format: int64
total_session_duration_ms
required
integer format: int64
waiting_for_tool_results_session_count
required
integer format: int64
Agent not found
Standard error response for API endpoints.
object
error
required
Error message describing what went wrong.
string
Internal server error
Standard error response for API endpoints.
object
error
required
Error message describing what went wrong.
string