Agent Conversations
Stream a voice agent conversation's merged recording
Streams the whole-call merged stereo recording as a WAV (audio/wav) byte stream through the service
(no SAS URL). This route serves Foundry-managed storage only. For bring-your-own-storage (BYOS)
recordings the bytes are not proxied — the caller must download directly from customer storage using the
blob_uri returned by the metadata route — so this route returns 409 Conflict for BYOS recordings.
While the conversation is in_progress, this route returns retriable 409 Conflict with
error.code = recording_not_ready and a Retry-After header when retry guidance is available. When the
conversation is failed, it returns terminal 409 Conflict with error.code = recording_unavailable.
For a completed conversation, content is available subject to the existing BYOS behavior. A conversation
without persisted audio (store = false) returns 404.
Header parameters
Foundry-Features
enum
required
A feature flag opt-in required when using preview operations or modifying persisted preview resources.
Path parameters
agent_name
string
required
The name of the agent.
conversation_id
string
required
The id of the conversation whose merged recording is streamed.
Query parameters
api-version
string
required
The API version to use for this operation.
Responses
A streamed WAV (audio/wav) audio response. The bytes are streamed through the service; no SAS URL is returned.
Body
Request
GET /agents/{agent_name}/endpoint/protocols/voice/conversations/{conversation_id}/audio/content HTTP/1.1Response
Status: 200
Content-Type: audio/wavStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json