--- name: omni-usage-logs description: 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.
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.