Skip to main content
GET
Retrieve Session

Path Parameters

session_id
string
required

Response

session_id
string
required
read-only
client_sdp
unknown
required
server_sdp
unknown
required
prompt
object
required
llm_type
object
required
model_style
object
required
tts_type
object
required
text_normalization_config
object
required
text_normalization_locale
string | null
required
read-only
stt_type
object
required
stt_text_normalization_config
object
required
stt_text_normalization_locale
string | null
required
read-only
ice_servers
unknown
required
status
enum<string>
required
  • CREATED - Created
  • EXCHANGED - Exchanged
  • IN_PROGRESS - In Progress
  • TERMINATED - Terminated
Available options:
CREATED,
EXCHANGED,
IN_PROGRESS,
TERMINATED
termination_reason
required
  • GRACEFUL_TERMINATION - Graceful Termination
  • SESSION_EXPIRED_BEFORE_CONNECTION - Session Expired Before Connection
  • SESSION_LOST_AFTER_CONNECTION - Session Lost After Connection
  • SESSION_MISC_ERROR - Session Misc Error
  • MAX_ACTIVE_SESSION_QUOTA_EXCEEDED - Max Active Session Quota Exceeded
  • MAX_MIN_PER_SESSION_QUOTA_EXCEEDED - Max Min Per Session Quota Exceeded
  • TOTAL_MIN_PER_MONTH_QUOTA_EXCEEDED - Total Min Per Month Quota Exceeded
  • INSUFFICIENT_CREDITS - Insufficient Credits
Available options:
GRACEFUL_TERMINATION,
SESSION_EXPIRED_BEFORE_CONNECTION,
SESSION_LOST_AFTER_CONNECTION,
SESSION_MISC_ERROR,
MAX_ACTIVE_SESSION_QUOTA_EXCEEDED,
MAX_MIN_PER_SESSION_QUOTA_EXCEEDED,
TOTAL_MIN_PER_MONTH_QUOTA_EXCEEDED,
INSUFFICIENT_CREDITS
duration_sec
integer
required
read-only
created_at
string<date-time>
required
read-only
session_acls
string[]
required
read-only
padding_left
number<double> | null
required
read-only
padding_top
number<double> | null
required
read-only
padding_height
number<double> | null
required
read-only
background_image
object
required
extra_data
unknown
required
capability
object[]
required
read-only
agent_config
object
required
interactive_agent_config
object
required

Read-only discovery view of an interactive-agent config. Exposes the identifier/name/owner plus the client-facing intro_message so a caller can pick a pliac-* to attach at session create; prompts, tools, per-role models, endpoint and credentials are NOT exposed (operator-managed, and globals are shared across orgs).

mcp_servers
object[]
required
read-only
document
string | null