For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Connect
BlogHelp CenterAPI PricingSign up
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
  • Get started
    • Overview
    • Quickstart
  • Configure
    • Overview
    • Voice & language
    • Knowledge base
    • Tools
    • Personalization
    • Authentication
  • Deploy
    • Overview
    • Environment variables
    • WhatsApp
    • Batch calls
  • Monitor
    • Overview
    • Users
    • Testing
    • Experiments
    • Versioning
    • Conversation Analysis
    • Analytics
    • Real-time monitoring
    • OpenTelemetry traces
    • Privacy
    • Cost optimization
    • CLI
  • Advanced
    • Events
    • Custom models
    • LLM cascading
    • Post-call webhooks
  • Resources
    • UI components
  • Guides
    • Chat Mode
    • Burst pricing
    • ElevenLabs' docs agent
    • Scaling user interviews
    • Simulate Conversations
        • WSSAgent WebSockets
          • POSTImport phone number
          • GETList phone numbers
          • GETGet phone number
          • PATCHUpdate phone number
          • DELDelete phone number
          • GETGet SIP messages for a phone number
LogoLogo
Login
Login
Connect
BlogHelp CenterAPI PricingSign up
API referencePhone Numbers

Update phone number

PATCH
/v1/convai/phone-numbers/:phone_number_id
PATCH
/v1/convai/phone-numbers/:phone_number_id
$curl -X PATCH https://api.elevenlabs.io/v1/convai/phone-numbers/phone_number_id \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "provider": "twilio",
3  "label": "Customer Support",
4  "phone_number": "+1234567890",
5  "phone_number_id": "phone_123"
6}
Update assigned agent of a phone number
Was this page helpful?
Previous

Delete phone number

Next
Built with

Path parameters

phone_number_idstringRequired
The id of an agent. This is returned on agent creation.

Headers

xi-api-keystringOptional

Request

This endpoint expects an object.
agent_idstring or nullOptional
labelstring or nullOptional
inbound_trunk_configobject or nullOptional
outbound_trunk_configobject or nullOptional
livekit_stackenum or nullOptionalDefaults to standard
Allowed values:
store_sip_messagesboolean or nullOptional
environmentstring or nullOptional
Environment to use for resolving environment variables on calls to this number.
branch_idstring or nullOptional
Agent branch to use for calls to this number.

Response

Successful Response
twilioobject
OR
exotelobject
OR
sip_trunkobject

Errors

422
Unprocessable Entity Error