Update Phone Number

from vapi import Vapi
client = Vapi(
    base_url="https://api.vapi.ai",
    token="YOUR_TOKEN_HERE"
)
client.phone_numbers.update(
    id="id",
    request=
)

{
  "provider": "byo-phone-number",
  "createdAt": "2024-01-15T09:30:00Z",
  "credentialId": "cred-abc123xyz",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "orgId": "org-987654321",
  "updatedAt": "2024-01-15T09:30:00Z",
  "assistantId": "assistant-1234abcd",
  "fallbackDestination": {
    "message": "Please hold while we transfer your call.",
    "type": "number",
    "numberE164CheckEnabled": true,
    "number": "+14155552671",
    "extension": "101",
    "callerId": "+14155551234",
    "transferPlan": {
      "mode": "blind-transfer",
      "message": "Connecting you now.",
      "timeout": 60,
      "sipVerb": "refer",
      "dialTimeout": 60,
      "holdAudioUrl": "https://example.com/audio/hold-music.mp3",
      "transferCompleteAudioUrl": "https://example.com/audio/transfer-complete.wav",
      "contextEngineeringPlan": {
        "type": "lastNMessages",
        "maxMessages": 5
      },
      "twiml": "<Say voice=\"alice\" language=\"en-US\">Hello, transferring a customer to you.</Say><Pause length=\"2\"/><Say>They called about billing questions.</Say>",
      "summaryPlan": {
        "messages": [
          {}
        ],
        "enabled": true,
        "timeoutSeconds": 5
      },
      "sipHeadersInReferToEnabled": true,
      "fallbackPlan": {
        "message": "Sorry, the transfer failed. Please try again later.",
        "endCallEnabled": true
      }
    },
    "description": "Main office line"
  },
  "hooks": [
    {
      "on": "call.ringing",
      "filters": [
        {
          "type": "startsWith",
          "key": "number",
          "startsWith": [
            "91",
            "86",
            "7"
          ]
        }
      ],
      "do": [
        {
          "type": "transfer",
          "destination": {
            "message": "Please wait while we connect your call.",
            "type": "number",
            "numberE164CheckEnabled": true,
            "number": "+14155559876",
            "extension": "202",
            "callerId": "+14155551234",
            "transferPlan": {
              "mode": "blind-transfer",
              "message": "Connecting now.",
              "timeout": 60,
              "sipVerb": "refer",
              "dialTimeout": 60,
              "holdAudioUrl": "https://example.com/audio/hold-music.mp3",
              "transferCompleteAudioUrl": "https://example.com/audio/transfer-complete.wav",
              "contextEngineeringPlan": {
                "type": "lastNMessages",
                "maxMessages": 3
              },
              "twiml": "<Say voice=\"alice\" language=\"en-US\">Transferring your call.</Say>",
              "summaryPlan": {
                "messages": [
                  {}
                ],
                "enabled": true,
                "timeoutSeconds": 5
              },
              "sipHeadersInReferToEnabled": true,
              "fallbackPlan": {
                "message": {},
                "endCallEnabled": true
              }
            },
            "description": "Support line"
          }
        }
      ]
    }
  ],
  "name": "Main Office Number",
  "number": "+14155551234",
  "numberE164CheckEnabled": true,
  "server": {
    "timeoutSeconds": 20,
    "credentialId": "550e8400-e29b-41d4-a716-446655440000",
    "staticIpAddressesEnabled": false,
    "encryptedPaths": [
      "/call.details",
      "/call.transcript"
    ],
    "url": "https://webhook.example.com/vapi",
    "headers": {},
    "backoffPlan": {
      "type": "fixed",
      "maxRetries": 3,
      "baseDelaySeconds": 2,
      "excludedStatusCodes": [
        400,
        401,
        403,
        404
      ]
    }
  },
  "squadId": "squad-9012ijkl",
  "status": "active",
  "workflowId": "workflow-5678efgh"
}

Authentication

AuthorizationBearer

Retrieve your API Key from Dashboard.

Path parameters

idstringRequired

Request

This endpoint expects an object.

byo-phone-numberobjectRequired

twilioobjectRequired

vonageobjectRequired

vapiobjectRequired

telnyxobjectRequired

Response

byo-phone-numberobject

twilioobject

vonageobject

vapiobject

telnyxobject