Sign in
voice_agents

Assign Phone Number

Assign a phone number to a voice agent.

Logic:

  1. Check if agent already has a phone number assigned
  2. Look for an available (unassigned) Twilio phone number
  3. If no available number, create a new Twilio phone number
  4. Assign the number to the agent's external_id
post/voice_agents/voice-agents/{voice_agent_id}/assign-phone-number

Path parameters

voice_agent_idstring uuid required

Response

Successful Response

external_idstring required
external_created_atstring date-time required
external_updated_atstring date-time required
external_assistant_idstring nullable required
numberstring required
namestring nullable required
provider'twilio' | 'byo-phone-number' | 'telnyx' required
status'active' | 'activating' | 'blocked' nullable required
outbound_voice_agent_idstring uuid nullable required
idstring uuid required
tenant_idstring uuid nullable
inbound_voice_agent_idstring uuid nullable
voice_platformstring nullable
livekit_dispatch_rule_idstring nullable
livekit_inbound_trunk_idstring nullable
livekit_outbound_trunk_idstring nullable
sip_prefix_to_stripstring nullable
sip_default_regionstring nullable
languagestring nullable
intent_contextstring nullable

Changes