admin

Get usage breakdown by detected session

Changed on

Returns a bounded page of request, token, and cost aggregates for detected, user-path-scoped sessions. Requests and tokens include local-cache hits; costs represent provider spend only. Usage without a detected session is omitted.

get/admin/usage/sessions

Request

  • Base URL
    http://localhost:8080
  • URL
    http://localhost:8080/admin/usage/sessions
  • Auth
    HTTP bearer

Query parameters

daysinteger

Number of days (default 30)

start_datestring

Start date (YYYY-MM-DD)

end_datestring

End date (YYYY-MM-DD)

modelstring[]

Filter by exact model names; repeat or comma-separate for several

providerstring[]

Filter by provider names or types; repeat or comma-separate for several

labelstring[]

Filter by request labels (exact match); repeat for several

endpointstring[]

Filter by exact request endpoints, e.g. /v1/chat/completions,/v1/messages; repeat or comma-separate for several

operationstring

Filter by comma-separated operations, e.g. chat_completions,embeddings

session_idstring

Filter by exact detected session ID

auth_key_idstring[]

Filter by managed auth key IDs; repeat or comma-separate for several

user_pathstring[]

Filter by tracked user path subtrees; repeat for several

limitinteger

Page size (default 50, max 200)

offsetinteger

Offset for pagination

Response

OK

limitinteger
offsetinteger
totalinteger

Changes

    • info

      for the query request parameter auth_key_id, the type was generalized from string to array

    • info

      for the query request parameter endpoint, the type was generalized from string to array

    • info

      for the query request parameter label, the type was generalized from string to array

    • info

      for the query request parameter model, the type was generalized from string to array

    • info

      for the query request parameter provider, the type was generalized from string to array

    • info

      for the query request parameter user_path, the type was generalized from string to array

    • info

      added the optional property // to the response with the status