Phone Numbers

Change what answers a number's inbound calls

Retype a number between AI answering, SDR answering and the dialer.

NOT a label change, and not free. Moving to dialer DESTROYS the LiveKit dispatch rule and both SIP trunks and repoints the carrier webhook; moving away from it builds them again. The number answers nothing in between, and the teardown is best-effort - a failed trunk delete is logged and the retype continues.

Retyping to the mode it is already in is a no-op, so this is safe to retry.

Voice compares the number's own org_id against the one sent, and this route sends the API key's - so another organisation's number is a 404 rather than a silent retype.

patch/voice/numbers/inbound-type

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/voice/numbers/inbound-type
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

numberstring required

The number to retype, E.164.

inbound_type'ai' | 'sdr' | 'dialer' | 'work' required

The answering mode to switch to.

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.