Phone Numbers

Reassign a phone number

Move a number to a different person, and tell voice about it.

Not a label: the assignee drives inbound ring targeting, missed-call notification and which numbers appear in that person's outbound caller-ID rotation pool.

ADMIN-ONLY through this API. The app also accepts the number's current assignee or its creator, but an API key is an ORGANISATION credential with no user_id, so it can never be either - leaving it to fall through to the role check is what made this route 403 for every key before the role was supplied.

patch/phone-numbers/update-assignee

Request

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

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

phone_numberstring required

The number to reassign, E.164.

assigneestring required

Who owns it now. This drives inbound ring targeting, missed-call notification and the outbound caller-ID pool - it is not a label.

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.