Skip to main content
GET
/
v1
/
agents
/
{agentId}
/
conversations
/
{conversationId}
/
audio
Get audio recording for a conversation
curl --request GET \
  --url https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio \
  --header 'x-api-key: <api-key>'
"<string>"

​
PII access and redaction

The redacted query parameter controls whether personally identifiable information (PII) is muted from the returned audio:
User PII accessredacted query valueAudio returned
Yesfalse (or omitted)Raw recording
YestrueRedacted recording
Nofalse (or omitted)Redacted recording (enforced)
NotrueRedacted recording
Users without PII access always receive the redacted recording, even when redacted=false is passed. This is enforced server-side, so callers cannot bypass redaction by omitting or overriding the query parameter. PII access is granted through your account’s role and permission configuration in Agent Studio. See PII logging for related conversation-log behavior.

​
Regional base URLs

RegionBase URL
UShttps://api.us.poly.ai
EUhttps://api.eu.poly.ai
UKhttps://api.uk.poly.ai
Studiohttps://api.studio.poly.ai
This endpoint is served from the Kong-routed host (api.{region}.poly.ai), not api.{region}-1.platform.polyai.app (which serves the list-conversations endpoint). Sending the request to the wrong host will fail.

​
Example

curl --request GET \
  --url "https://api.us.poly.ai/v1/agents/{agentId}/conversations/{conversationId}/audio?direction=combined&redacted=false" \
  --header "x-api-key: $POLYAI_API_KEY" \
  --output conversation.wav
Replace {agentId} and {conversationId} with real values — the placeholders are not resolved server-side. Only Accept: audio/wav is needed; do not send Content-Type on this GET request (it has no body).

​
Common pitfalls

SymptomLikely causeFix
404 Not Found or DNS errorUsing the wrong host (e.g. api.us-1.platform.polyai.app)Use api.{region}.poly.ai
404 Not Found on the conversationThe literal string {conversationId} was left in the URLSubstitute a real conversation ID from the List Conversations endpoint
401 UnauthorizedEmpty or wrong-region API keyIssue a region-scoped key from PolyAI

Authorizations

​
x-api-key
string
header
required

Contact your PolyAI representative.

Path Parameters

​
agentId
string
required

Agent ID.

​
conversationId
string
required

Unique conversation ID.

Query Parameters

​
direction
enum<string>
default:combined

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.

Available options:
combined,
user,
agent
​
redacted
boolean
default:false

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.

The response is of type file.

Last modified on June 1, 2026