Phone Numbers

Set a number's voice-side assignee

Point a number's voice-side assignment at someone else.

The VOICE half of PATCH /phone-numbers/update-assignee, which does this and updates the CDP record. Published separately because the app's propagation to voice is best-effort and only logs a warning when it fails - so the two records can disagree, and this is the way to reconcile them without re-running the whole reassignment.

Sending assigned_to: "" clears the assignment. Assigning a WORK number also creates the person's phone-directory row, which is what makes them findable by name to the receptionist.

patch/voice/numbers/assignee

Request

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

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

numberstring required

The number to reassign, E.164.

assigned_tostring required

Email of the new assignee, or "" to clear it. Normalised by voice before storage so inbound ring targeting, the dialer assignee filter and per-rep stat redaction all compare equal.

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.