Get org conversation usage stats
GET /api/organizations/{org_id}/conversations/usage-stats
Get detailed usage statistics for organization dashboard. Returns detailed metrics including active users, agent runs, token usage, daily breakdown, and team usage for the specified time window. Access Control: Requires VIEW_ORG_CONVERSATIONS permission (Admin or Owner role). Args: org_id: The organization ID time_window: Time window filter (7d, 30d, 90d, ytd) days: Number of days to look back (default 7) Returns: OrgUsageStats: Detailed usage statistics for the org
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org_id | path | `string | null` | yes |
time_window | query | `string | null` | no |
days | query | `integer | null` | no |
X-Org-Id | header | `string | null` | no |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
active_users | integer | no | — |
agent_runs | integer | no | — |
usage_conversation_count | integer | no | — |
total_tokens | integer | no | — |
estimated_spend | number | no | — |
daily_usage | DailyUsageData[] | no | — |
team_usage | TeamUsageData[] | no | — |
model_usage | ModelUsageData[] | no | — |
agent_usage | AgentUsageData[] | no | — |
Operation ID: get_org_conversation_usage_stats_api_organizations__org_id__conversations_usage_stats_get