Get Agent Metrics

Return an agent's session distribution, trailing spend, and usage over a window, by id or by name.

samples carries one entry per finished session (duration, cost, tokens) for distributions; spend_windows carries what the agent's sessions cost over the last 1, 7, and 28 days against its budget for each window; buckets splits start to end by interval, chosen from the window's length.

get/v1/agents/{id}/metrics

Request

Base URL
https://api.ellipsis.dev
URL
https://api.ellipsis.dev/v1/agents/{id}/metrics
Auth
HTTP bearer

Path parameters

idstring required

Query parameters

startstring date-time required

Inclusive start of the usage window. Naive timestamps use UTC.

endstring date-time required

Exclusive end of the usage window. Naive timestamps use UTC.

Headers

user-agentstring nullable

Response

Successful Response

interval'hour' | 'day' | 'week' required

The width of one entry in a time series, chosen from the window's length. A window of up to 3 days is split by hour, a window of up to 120 days by day, and a longer window by week. Every entry starts on a UTC boundary of its interval, and a week starts on Monday.

Changes

No recorded changes to this operation across all 1 revision of this API.