Skip to main content
GET
Get an agent

Authorizations

Authorization
string
header
required

A long-lived, privileged API key (ek_... prefix), minted once from the dashboard. Intended for trusted server-side use only; never expose it in client-side code. Send as Authorization: Bearer ek_.... Required by every Calls, Batches, Agents, Tools, MCP Servers, Documents, and Realtime route.

Path Parameters

agent_id
string
required

Response

Successful Response

agent_id
string
required
name
string
required
description
string
required
instruction
string
required
first_message
string
required
telephony
V1AgentTelephonyStatus · object
required
realtime
V1AgentRealtimeStatus · object
required

The effective realtime capabilities of this agent.

voice_id
string | null
language
string | null
language_code
string | null
accent
string | null
can_end_conversation
boolean
default:false
transfer_phone_number
string | null
transfer_criteria
string | null
variable_placeholders
Variable Placeholders · object
voicemail_config
VoicemailConfig · object | null
created_at
string | null