Get workspace usage overview

GET 
/api/v1/analytics/aggregate

Owner-level (NOT chatbot-scoped) 7-day cross-chatbot usage overview: per-day query trend + total queries, total chatbots, and deployed-chatbot count. Loops all chatbots the caller owns. FULL-ACCESS CALLER REQUIRED: a chatbot-scoped key (allowedChatbotIds set) receives 403 chatbot_not_in_key_scope — it cannot read workspace-wide totals. The dashboard success flag and debug block are never emitted. Tier-gated (usage, starter+). Required scope: analytics:read.

Request

Responses

200

Workspace-level usage overview for the calling owner.

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

429

Too Many Requests — rate limit exceeded