Agent Live Conversations

Get a Live conversation's merged recording metadata

GET /agents/{agent_name}/endpoint/protocols/voice/live/conversations/{conversation_id}/audio

Gets merged stereo recording metadata (user left, assistant right). BYOS uses unsigned blob_uri. Returns 404 for no audio, or 409 recording_not_ready/recording_unavailable for pending/failed finalization; pending responses may include Retry-After.

Header parameters

Foundry-Features enum required

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

VoiceAgents=V1Preview

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.

Query parameters

api-version string required

The API version to use for this operation.

Responses

The request has succeeded.

Body

Content-Type: application/json

conversation_id string required

The id of the conversation this recording belongs to.

format string | enum required

An audio container format. Additional values may be added over time.

Any of the following:

string

enum

wav

sample_rate integer required

The sample rate of the recording in Hz, e.g. 24000.

channels integer required

The number of audio channels. The merged recording is stereo (2).

channel_layout VoiceRecordingChannelLayout required

The role assigned to each channel of a merged stereo voice recording.

left enum required

The role carried on the left channel. Always user.

user

right enum required

The role carried on the right channel. Always agent.

agent

duration_ms integer required

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 /audio/content route instead.