Agent Conversations
Get a voice agent conversation item's audio metadata
Returns metadata for a single conversation item's audio segment, including the common playback facts
(role, format/codec, sample rate, channels, offset, duration) for both Foundry-managed and
bring-your-own-storage (BYOS) recordings; for BYOS the response additionally includes blob_uri, the URI
of the recording in the customer's own storage (no SAS) that the customer downloads with their own credentials.
Requires the conversation to have persisted audio (store = true); returns 404 when the conversation,
item, or its audio was not persisted.
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 metadata is retrieved.
Query parameters
api-version
string
required
The API version to use for this operation.
Responses
The request has succeeded.
Body
conversation_id
string
required
The id of the conversation the item belongs to.
item_id
string
required
The id of the item this audio belongs to.
role
string | enum
A voice-audio participant role. Additional values may be added over time.
enum
format
string | enum
An audio container format. Additional values may be added over time.
enum
codec
string | enum
An audio codec. Additional values may be added over time.
enum
sample_rate
integer
The sample rate in Hz.
channels
integer
The number of audio channels.
start_offset_ms
integer
A duration encoded as an integer number of milliseconds.
duration_ms
integer
A duration encoded as an integer number of milliseconds.
blob_uri
string
For bring-your-own-storage (BYOS) recordings only: the URI of the recording in the customer's own storage, without a SAS token. The customer downloads it using their own storage credentials. Absent for Foundry-managed storage, where the bytes are streamed via the item's /audio/content route instead.
Request
GET /agents/{agent_name}/endpoint/protocols/voice/conversations/{conversation_id}/items/{item_id}/audio HTTP/1.1Response
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json