Update Twilio Number

Update a Twilio number and associate it with a channel.

PUT/api/v1/channels/twilio/{channel_id}/numbers

Authentication

Syllable-API-Keyrequired

Send Syllable-API-Key in the header.

Need a credential? Create or manage an API token in the Syllable Console.

Parameters

Path parameters

channel_id integer path required

Request body

application/json

body TwilioNumberUpdateRequest required

2 fields

friendly_namestringrequired

Friendly name for the Twilio number

phone_sidstringrequired

Twilio number SID

Request example

{
  "friendly_name": "string",
  "phone_sid": "string"
}

Responses

200Successful Response

application/json

response TwilioNumberUpdateResponse required

1 field

phone_numberstringrequired

The updated Twilio phone number

Response example

{
  "phone_number": "string"
}

422Validation Error

application/json

response HTTPValidationError required

1 field

detailValidationError[]optional

Item schema

itemsValidationErrorrequired

3 fields

locstring | integer[]required

Item schema

itemsstring | integerrequired

2 options

Option 1stringrequired

Option 2integerrequired

msgstringrequired

typestringrequired

Response example

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Code examples

import { SyllableSDK } from "syllable-sdk";

const syllableSDK = new SyllableSDK({
  apiKeyHeader: process.env["SYLLABLE_API_KEY"] ?? "",
});

async function run() {
  const result = await syllableSDK.channels.twilio.numbers.update({
    channelId: 815949,
    twilioNumberUpdateRequest: {
      friendlyName: "Support Line",
      phoneSid: "PN123",
    },
  });

  console.log(result);
}

run();

import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLE_API_KEY", ""),
) as ss_client:

    res = ss_client.channels.twilio.numbers.update(channel_id=815949, twilio_number_update_request={
        "friendly_name": "Support Line",
        "phone_sid": "PN123",
    })

    # Handle response
    print(res)

curl --request PUT \
  --url 'https://api.syllable.cloud/api/v1/channels/twilio/%7Bchannel_id%7D/numbers' \
  --header 'content-type: application/json' \
  --data '{
  "friendly_name": "string",
  "phone_sid": "string"
}'