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

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

Request body

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

DELETE https://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

Re-verifying a number

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

1. DELETE the existing entry
2. 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).