Phone Numbers

Switch a number between dialer and voice AI

Change what a number is for, and re-provision it to match.

This reaches the voice platform: the LiveKit trunks and the carrier voice_url are re-pointed so inbound calls arrive where the new capability says they should. A number is briefly answering neither while that happens.

The two flags are not independent. dialer set with voice unset means dialer; every other combination means voice AI - which is the app's own derivation, mirrored rather than reinvented.

Admin-only for the same reason as update-assignee.

patch/phone-numbers/update-capabilities

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/phone-numbers/update-capabilities
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

phone_numberstring required

The number to reconfigure, E.164.

voiceboolean

Answer inbound calls with a voice AI agent.

dialerboolean

Use the number for outbound dialing.

Response

Successful Response

dataPhoneNumberPayload required

An open envelope for a purchase result, a release, or an A2P job.

Open on purpose. A purchase returns the stored row (whose capability and provider-metadata keys differ per provider), a workflow start returns a workflow_id, and the A2P reconcile returns per-number outcomes that grow as carriers add statuses. Pinning it would silently drop whatever the provider reported that this contract had not caught up on.

Changes

No recorded changes to this operation across all 2 revisions of this API.