Admin (Super-Admin)
Overview
The admin endpoints provide cross-tenant analytics visible only to super-admin API keys. Use them to monitor platform-wide call volume, per-user consumption, and token usage.
Authentication
All admin endpoints require a super-admin API key:
The API key must have is_super_admin set to true. Regular API keys receive a 403 Forbidden response.
Available Endpoints
Call Analytics
| Endpoint | Description |
|---|---|
| Dashboard | Cross-tenant call totals, duration, status breakdown, and active user count. |
| Calls by User | Per-user call count and duration. |
| Calls by Phone Number | Cross-tenant destination number breakdown. |
| Calls by Service | Cross-tenant service breakdown (exotel, twilio, web). |
Token and Usage Analytics
| Endpoint | Description |
|---|---|
| Token Summary | Aggregate LLM token and TTS usage across the platform. |
| Tokens by User | Per-user token consumption breakdown. |
| Tokens by Assistant | Per-assistant token consumption breakdown. |
Common Query Parameters
Most admin endpoints accept:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
start_date |
datetime | No | 30 days ago | ISO 8601 start of range. |
end_date |
datetime | No | Now | ISO 8601 end of range. |
user_email |
string | No | -- | Narrow results to a specific user (where supported). |
Super-admin only
These endpoints expose data across all users. Treat the API key with the same care as database credentials.