REST API: analytics and activity

Analytics endpoints return dashboard data on statistics, daily trends, sentiment, feedback, confidence, retrieval modes, geography, low-confidence responses, and escalations. These are reporting endpoints. The generated reference documents their filters and date rules.

A date-only dateTo value includes the full UTC day, through its end. Timestamp inputs need an explicit time zone. A reversed date range causes a validation error.

Exports run as an asynchronous process. You create an export, save its ID, and poll that resource at a reasonable interval. Activity sessions use separate pagination and message-detail routes. The analytics cursor pattern does not apply to them.

The API returns audio URLs one message at a time. Session deletion, alone or in bulk, removes data permanently. You must decide on data retention before you delete a session.

Give reporting jobs read-only access where possible. Limit access to individual messages. Keep dashboard metric interpretation separate from claims about answer quality. Use rate-limit headers and backoff for scheduled exports or large activity reviews.