Mark a phone number as verified

put

Mark a customer's phone number as verified or unverified. Only one phone number can be verified at a time per agent.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

The agent ID

customerIdstringRequired

The customer ID

phoneNumberIdstringRequired

The phone number ID

Body

application/json

valuebooleanRequired

Whether to mark the phone number as verified (true) or unverified (false)

replacePolicystring · enumOptional

How to handle existing verified numbers: 'reject' to throw error if another number is verified, 'override' to unverify existing verified number

Possible values:

Responses

200

Phone number verification status updated successfully

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict - Another phone number is already verified

application/json

500

Internal Server Error

application/json

put

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

HTTPcURLJavaScriptPython

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

{
  "value": true,
  "replacePolicy": "reject"
}

{
  "id": "text",
  "phoneNumber": "text",
  "type": "primary",
  "phoneType": "text",
  "lineType": "landline",
  "lineStatus": "active",
  "verified": true,
  "note": "text",
  "conversationSid": "text",
  "createdAt": "2025-12-09T23:10:00.737Z",
  "updatedAt": "2025-12-09T23:10:00.737Z"
}