Update Phone Number

curl --request PUT \ --url https://api.example.com/v1/phone-numbers/{phone_number_id} \ --header 'Content-Type: application/json' \ --data ' { "routing_target_type": "<string>", "routing_target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "server_url": "<string>", "sms_enabled": false, "metadata": {} } '

Headers

authorization

string | null

Path Parameters

phone_number_id

string<uuid>

required

Body

application/json

In-place update of a binding's routing/SMS config.

The number's identity (SID, E.164) and its server_url_secret are stable — call-init endpoints keep verifying with the same secret across edits.

routing_target_type

string

required

Pattern: ^(agent|workflow|webhook)$

routing_target_id

string<uuid> | null

server_url

string | null

Maximum string length: 2048

sms_enabled

boolean

default:false

metadata

Metadata · object | null

Response

Successful Response

The response is of type Response Update Phone Number V1 Phone Numbers Phone Number Id Put · object.