Agent Conversations
Get a voice agent conversation item's generated audio metadata
Returns metadata for a conversation item's generated audio. This subordinate artifact is separate from the
canonical heard-audio segment and exists only when playback was interrupted and the service rendered more audio
than the listener heard, including when the response ends as cancelled. Returns 404 when the conversation or
item was not persisted, or when no generated audio exists beyond the heard segment.
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 generated 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 generated audio 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/generated/content route instead.
Request
GET /agents/{agent_name}/endpoint/protocols/voice/conversations/{conversation_id}/items/{item_id}/audio/generated HTTP/1.1Response
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json