Get conversation audio

Fetch the WAV audio recording for a conversation. Users without PII access automatically receive the redacted recording.

GET /v3/{account_id}/{project_id}/conversations/{conversation_id}/audio

Get audio recording for a conversation

cURL

curl --request GET \
  --url https://api.us-1.platform.polyai.app/v3/{account_id}/{project_id}/conversations/{conversation_id}/audio \
  --header 'x-api-key: <api-key>'

200

"<string>"

PII access and redaction

The redacted query parameter controls whether personally identifiable information (PII) is muted from the returned audio:

User PII access	redacted query value	Audio returned
Yes	false (or omitted)	Raw recording
Yes	true	Redacted recording
No	false (or omitted)	Redacted recording (enforced)
No	true	Redacted 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.

Example

curl --request GET \
  --url "https://api.us-1.platform.polyai.app/v3/{account_id}/{project_id}/conversations/{conversation_id}/audio?direction=combined&redacted=false" \
  --header "x-api-key: $POLYAI_API_KEY" \
  --output conversation.wav

Authorizations

x-api-key · string · header · required

Contact your PolyAI representative.

Path Parameters

account_id · string · required

Account ID.

project_id · string · required

Project ID.

conversation_id · 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

200

audio/wav

WAV audio recording for the conversation.

The response is of type file.