omni-usage-logs

Overview

Access detailed call logs and usage analytics. Filter by provider, model, time range, status, and cost. Export logs and aggregate token usage across all connections.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.

Endpoints

GET /api/usage/analytics

Get usage analytics

curl https://localhost:20128/api/usage/analytics \
  -H "Authorization: Bearer $AIRoute_TOKEN"

GET /api/usage/call-logs

Get call logs

curl https://localhost:20128/api/usage/call-logs \
  -H "Authorization: Bearer $AIRoute_TOKEN"

GET /api/usage/call-logs/{id}

Get a specific call log

curl https://localhost:20128/api/usage/call-logs/{id} \
  -H "Authorization: Bearer $AIRoute_TOKEN"

GET /api/usage/{connectionId}

Get usage for a specific connection

curl https://localhost:20128/api/usage/{connectionId} \
  -H "Authorization: Bearer $AIRoute_TOKEN"

GET /api/usage/history

Get usage history

curl https://localhost:20128/api/usage/history \
  -H "Authorization: Bearer $AIRoute_TOKEN"

GET /api/usage/logs

Get usage logs

curl https://localhost:20128/api/usage/logs \
  -H "Authorization: Bearer $AIRoute_TOKEN"

GET /api/usage/proxy-logs

Get proxy logs

curl https://localhost:20128/api/usage/proxy-logs \
  -H "Authorization: Bearer $AIRoute_TOKEN"

GET /api/usage/request-logs

Get request logs

curl https://localhost:20128/api/usage/request-logs \
  -H "Authorization: Bearer $AIRoute_TOKEN"

GET /api/usage/budget

Get usage budget status

Returns current budget limits and consumption.

curl https://localhost:20128/api/usage/budget \
  -H "Authorization: Bearer $AIRoute_TOKEN"

POST /api/usage/budget

Configure usage budget

Set or update budget limits for usage tracking.

curl -X POST https://localhost:20128/api/usage/budget \
  -H "Authorization: Bearer $AIRoute_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.