Agent Live Conversations
Get a Live conversation item's audio metadata
Gets captured speech-audio metadata. BYOS uses unsigned blob_uri. Returns 404 for missing audio, conversations not stored, or delegation items.
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 Live voice agent.
conversation_id
string
required
The Foundry conversation ID returned in session.started.conversation_id.
item_id
string
required
The id returned on the persisted item.
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/live/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