Get advanced analytics insights

GET 
/api/v2/projects/:slug/analytics/insights/

Surface conversation-driven insights for the project: top recurring questions (faqs) and content gaps where users asked something the assistant could not answer (content_gaps). Each item includes the related chats so you can drill into the original conversations.

Plan-gated: requires a plan that includes advanced analytics. When your team does not have access, the endpoint returns 200 with { "has_access": false } and no payload. Treat that as a successful response rather than an error, and prompt the user to upgrade.

Required permission: analytics_read

Request

Responses

200

Insights retrieved successfully (or has_access: false if the team is on a plan without advanced analytics)

400

Bad request. Invalid or missing data.

403

Forbidden. Missing permissions.

404

Resource not found.