Get usage analytics

GET 
/api/v1/chatbots/:chatbotId/analytics/usage

Returns usage analytics for a single chatbot. tokenCount and queryCount are derived from cost rollup data (same tier-gating as cost analytics). Note: queryCount counts recorded cost/usage events (model calls — embeddings, completions, reranks, tool calls — plus other cost events), not user Q&A turns, so expect it to run several × the conversations/quality turn counts. documentCount is the current KB size (total docs in user_documents — not time-windowed). No PII. Required scope: analytics:read.

Request

Responses

200

Usage analytics for the chatbot.

400

Bad Request — invalid input

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

404

Not Found

429

Too Many Requests — rate limit exceeded