Get Handler Metrics

Return session counts and accumulated spend for a saved handler.

Filters only by session creation time. buckets splits the window by interval, chosen from the window's length. Counts use the current turn and conversation state, so an open conversation awaiting another message remains active. Spend includes the selected sessions' full accumulated cost, including activity after the creation-time window. Only sessions carrying this exact saved handler id are counted; legacy sessions without handler provenance are excluded.

spend_windows reports current trailing 1-, 7-, and 28-day spend, including subscription tokens, and effective handler budgets across all attributed sessions. Those windows use usage timestamps and are independent of start/end.

Requires configs:read matching handlers/{service} and unrestricted sessions:read. Session tokens with both grants may read metrics.

get/v1/handlers/{id}/metrics

Request

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

Path parameters

idstring required

Query parameters

startstring date-time required

Inclusive session creation-time bound. Naive timestamps use UTC.

endstring date-time required

Exclusive session creation-time bound. Naive timestamps use UTC.

Headers

user-agentstring nullable

Response

Successful Response

endstring date-time required

Exclusive session creation-time bound.

handler_idstring required

The saved handler whose sessions are counted.

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.

startstring date-time required

Inclusive session creation-time bound.

Changes

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