The Data API provides programmatic access to conversation records, audio recordings, annotations, notes, and debug chat sessions generated by your PolyAI agents. Use it for analytics pipelines, QA workflows, compliance reporting, and interactive testing.
What you can do
- List conversations for a project and retrieve full conversation detail by ID.
- Fetch the WAV audio recording for a conversation (with PII-redaction controls).
- Add turn-level annotations (
missing_topic, wrong_transcript, wrong_info) to flag issues for review.
- Upsert free-form notes on a conversation.
- Create and exchange messages in debug chat sessions to test agent variants outside of production traffic.
Regional base URLs
| Region | Base URL |
|---|
| US | https://api.us.poly.ai |
| EU | https://api.eu.poly.ai |
| UK | https://api.uk.poly.ai |
| Studio | https://api.studio.poly.ai |
Authentication
The Data API uses API key authentication with the X-API-KEY header. API keys are scoped to account, project, and region. Issue keys from the API keys section of Agent Studio, or request one from your PolyAI representative.
curl --request GET \
--url "https://api.us.poly.ai/v1/agents/{agentId}/conversations" \
--header "X-API-KEY: $POLYAI_API_KEY"
Last modified on June 4, 2026
