Update a phone number

patch

Update a phone number for a customer. Both primary and secondary phone numbers can be updated.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

customerIdstringRequired

phoneNumberIdstringRequired

Body

application/json

phoneNumberstring · min: 1Optional

phoneTypestring · min: 1Optional

lineTypestring · enumOptionalPossible values:

lineStatusstring · enumOptionalPossible values:

notestringOptional

Responses

200

Phone number updated successfully

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

patch

/v1/agents/{agentId}/customers/{customerId}/phone-numbers/{phoneNumberId}

HTTPcURLJavaScriptPython

PATCH /v1/agents/{agentId}/customers/{customerId}/phone-numbers/{phoneNumberId} HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "phoneNumber": "text",
  "phoneType": "text",
  "lineType": "landline",
  "lineStatus": "active",
  "note": "text"
}

{
  "id": "text",
  "phoneNumber": "text",
  "type": "primary",
  "phoneType": "text",
  "lineType": "landline",
  "lineStatus": "active",
  "verified": true,
  "note": "text",
  "conversationSid": "text",
  "createdAt": "2025-12-11T11:23:20.727Z",
  "updatedAt": "2025-12-11T11:23:20.727Z"
}