Set a number's voice-side assignee
PATCH /voice/numbers/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.
Authorizations
Parameters
Header Parameters
Request Body required
Point a number’s voice-side assignment at someone else.
Mirrors graph8_livekit.schemas.numbers.UpdateAssignee minus org_id.
assigned_to is REQUIRED but may be the empty string, which is how voice
spells “clear the assignment” - its own normalisation passes falsy input
through untouched for exactly that reason.
object
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.
The number to reassign, E.164.
Responses
200
Successful Response
object
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.
object
object
Whether there are more pages
Items per page
Current page number (1-indexed)
Total number of items
422
Validation Error