| 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.
