Skip to main content
POST
/
v1
/
sip
/
update
Update SIP Direction
curl --request POST \
  --url https://api.bland.ai/v1/sip/update \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "phone_number": "<string>",
  "updates": {}
}
'
{
  "register_password_for_pbx": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body

​
phone_number
string
required
The phone number to update. Must be in E.164 format.
​
updates
object
required
The updated direction object. Must include type ("inbound" or "outbound").
For outbound updates, you can modify sip_endpoint, options (port, transport, secure_media, sip_username, sip_password), and headers. For inbound updates, you can modify auth_mode, register_auth, sip_endpoint, options, and headers.

​
Response

​
register_password_for_pbx
string
Returned when switching to or updating registration-based auth. Configure this password in your PBX.
Example Request
curl -X POST https://api.bland.ai/v1/sip/update \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+14150000000",
    "updates": {
      "type": "outbound",
      "sip_endpoint": "sip:new.provider.com",
      "options": {
        "port": 5061,
        "transport": "tls",
        "secure_media": true
      }
    }
  }'
Docs for agents: llms.txt