Agent Live Conversations
Get a Live voice agent conversation item
Gets a stored item by ID. Returns 404 if the item or conversation is absent.
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
input
VoiceAgentLiveInputConversationItem
A stored user speech segment.
type
enum
required
transcription
string
Captured user transcription, when available.
audio
VoiceAudioItem
Metadata for a single conversation item's audio segment. For bring-your-own-storage (BYOS), the response includes blob_uri, a direct customer-storage URI without a SAS token, that the customer accesses with their own credentials. For Foundry-managed storage, blob_uri is absent and the bytes are streamed through the item's /audio/content route.
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.
output
VoiceAgentLiveOutputConversationItem
A stored assistant speech segment.
type
enum
required
transcription
string
Captured assistant transcription, not backend output or commentary guidance.
audio
VoiceAudioItem
Metadata for a single conversation item's audio segment. For bring-your-own-storage (BYOS), the response includes blob_uri, a direct customer-storage URI without a SAS token, that the customer accesses with their own credentials. For Foundry-managed storage, blob_uri is absent and the bytes are streamed through the item's /audio/content route.
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.
delegation
client | responses | foundry_managed_agent
A stored delegation using native fields with Foundry-specific targets. Its id is the native delegation ID.
client
VoiceAgentLiveClientDelegationConversationItem
Results supplied by the application for client delegation.
target
enum
required
commentary
string
Guidance for Live to communicate to the user, when accepted.
thinking
string
Accepted background context, not private reasoning or a request to speak.
responses
VoiceAgentLiveResponsesDelegationConversationItem
Stored Responses delegation output, separate from Live speech.
target
enum
required
output
string
Final backend text, omitted when unavailable; excludes raw tool output.
foundry_managed_agent
VoiceAgentLiveFoundryManagedAgentDelegationItem
Stored prompt-agent delegation state and accepted results.
target
enum
required
agent_name
string
required
Target agent name in the same project.
agent_version
string
required
Target version pinned at connection start.
offset_ms
integer
required
A duration encoded as an integer number of milliseconds.
backend_conversation_id
string
Backend conversation ID, distinct from the voice conversation and Live session IDs.
output
VoiceAgentLiveDelegationResultItem[]
required
Accepted guidance in order; empty until a result is accepted. Entries have no individual IDs, are noncumulative, and are independent of backend output_index. Partial results survive failure or cancellation.
delegation_context
string
Task context sent to the target agent, not the full request body.
status
string | enum
required
Persisted delegation outcome, not speech or playback status.
enum
Request
GET /agents/{agent_name}/endpoint/protocols/voice/live/conversations/{conversation_id}/items/{item_id} HTTP/1.1Response
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json