Manage Caller IDs

Two write endpoints for housekeeping after verification.

Update alias

Change the friendly label on an existing caller ID. The phone number itself is immutable — to change it, delete and re-verify.

Endpoint

PUThttps://api.tryvox.io/v1/voice/accounts/{auth_id}/verified-caller-ids/{phone_number}

Request body

Parameter	Type	Required	Description
`alias`	string	yes	New alias. Pass `""` to clear.

Example request

curl -X PUT https://api.tryvox.io/v1/voice/accounts/$TRYVOX_AUTH_ID/verified-caller-ids/+919876543210 \
  -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  -H "Content-Type: application/json" \
  -d '{"alias": "Bangalore office"}'

Response

200 OK — full caller ID record with the updated alias.

{
  "id": "8f7a4b2e-91c2-4f3d-9a1e-2c4b6d8f0a1c",
  "account_id": "TJab12cd34",
  "phone_number": "+919876543210",
  "alias": "Bangalore office",
  "verification_status": "verified",
  "verified_at": "2026-04-09T10:35:12Z",
  "created_at": "2026-04-09T10:30:00Z"
}

Delete

Remove a caller ID from the account. Works for both pending and verified entries. Once deleted, the number can no longer be used as from until re-verified.

Endpoint

DELETEhttps://api.tryvox.io/v1/voice/accounts/{auth_id}/verified-caller-ids/{phone_number}

Example request

curl -X DELETE https://api.tryvox.io/v1/voice/accounts/$TRYVOX_AUTH_ID/verified-caller-ids/+919876543210 \
  -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN

Response

204 No Content — empty body.

Behavior

Idempotent in effect: a follow-up DELETE for the same number returns 404 CALLER_ID_NOT_FOUND (the resource is gone, not the operation).
In-flight calls are unaffected. Existing call legs continue; only future outbound attempts using the deleted number as from will be rejected.
The id is not reusable. Re-verifying the same number gets a fresh id.

Errors

Status	Code	Reason	Applies to
400	`VALIDATION_FAILED`	Body missing or malformed	PUT
401	`INVALID_CREDENTIALS`	Auth ID / Auth Token bad	both
403	`FORBIDDEN`	Auth ID in URL doesn't match the authenticated key	both
404	`CALLER_ID_NOT_FOUND`	No entry for this `phone_number`	both

Re-verifying a number

There's no in-place "re-verify" operation. To roll a verified number back through the OTP flow:

DELETE the existing entry
POST to Initiate with the same number — you'll get a fresh id and a new OTP

This is the right path when you want to confirm a number is still controlled by the original owner (e.g. annual re-attestation).

On this page