v1

latestOpenAPI 3.1.02026-07-2687120159.0 KB

Conversations

Get audio recording for a conversation

Returns the audio recording for a conversation as a WAV file.

Host: this endpoint is served from api.{region}.poly.ai — not the api.{region}-1.platform.polyai.app host used by the list-conversations endpoint.

PII access enforcement. Users without PII access always receive the redacted recording, regardless of the redacted query parameter. Users with PII access receive the raw recording by default and can opt into the redacted version by passing redacted=true. PII access is granted through your account's role and permission configuration in Agent Studio.

get/v1/agents/{agentId}/conversations/{conversationId}/audio

Path parameters

agentIdstring required

Agent ID.

conversationIdstring required

Unique conversation ID.

Query parameters

direction'combined' | 'user' | 'agent'

Which side of the call to return. combined returns the full mixed recording. user returns only the caller audio. agent returns only the agent audio.

redactedboolean

If true, returns the redacted recording with personally identifiable information (PII) muted. If false, returns the raw recording. Users without PII access always receive the redacted recording, regardless of this parameter.

Response

WAV audio recording for the conversation.