Promote a phone number

post

Promote a secondary phone number to primary status. The current primary phone number will be demoted to secondary. Only secondary phone numbers can be promoted.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

customerIdstringRequired

phoneNumberIdstringRequired

Responses

200

Phone number promoted to primary successfully

application/json

This an object representing a customer's phone number.

idstringRequired

phoneNumberstringRequired

typestring · enumRequiredPossible values:

phoneTypestringRequired

lineTypestring · enumOptionalPossible values:

lineStatusstring · enumOptionalPossible values:

verifiedbooleanOptional

notestringOptional

conversationSidstringOptional

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post

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

HTTPcURLJavaScriptPython

POST /v1/agents/{agentId}/customers/{customerId}/phone-numbers/{phoneNumberId}/promote HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "phoneNumber": "text",
  "type": "primary",
  "phoneType": "text",
  "lineType": "landline",
  "lineStatus": "active",
  "verified": true,
  "note": "text",
  "conversationSid": "text",
  "createdAt": "2026-04-02T10:21:39.734Z",
  "updatedAt": "2026-04-02T10:21:39.734Z"
}