Agent Conversations
Stream a voice agent conversation item's audio
Streams a single conversation item's audio 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 item's /audio metadata route — so this route returns 409 Conflict for BYOS recordings.
Returns 404 when the conversation, item, or its audio was not persisted (store = false).
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 that contains the item.
item_id
string
required
The id of the conversation item whose audio 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}/items/{item_id}/audio/content HTTP/1.1
Response
Status: 200
Content-Type: audio/wav
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json