Agent Live Conversations

Get a Live voice agent conversation

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

Gets a stored Live conversation; fetch items separately. Returns 404 if absent or not stored.

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

id string required

The unique id of the conversation.

object enum required

The object type. Always voice.conversation.

voice.conversation

status string | enum required

The lifecycle status of a persisted voice conversation: - in_progress: the live session is active, or post-session persistence finalization is pending. - completed: finalization succeeded after normal or client close, end_conversation, a max-duration 1001 close, or a client or network disconnect that the service can still finalize. - failed: a terminal service, bridge, storage, or unrecoverable transport failure prevented finalization.

Any of the following:

string

enum

in_progresscompletedfailed

created_at integer required

completed_at integer

metadata object

A set of key-value pairs attached to the conversation.

[key: string] string

last_error OpenAI.Error

code string | null required

message string required

param string | null

type string

misalignment OpenAI.MisalignmentErrorDetailsResource

review_target string | null

error_type string | enum

Any of the following:

string

enum

potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother

detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer

message string required

The public continuation instruction.

details OpenAI.Error[]

Additional errors that contributed to this failure.

additionalInfo object

Additional structured information about the failure.

debugInfo object

Diagnostic information supplied by the service for troubleshooting.

usage OpenAI.LiveSessionUsage

Cumulative audio duration for a Live session. Values are totals for the session, not increments to sum across usage events.

seconds number required