latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

numbers

Assign a phone number to a user, IVR, or conference

Reassign a phone number to a different target: a user, an IVR, or a conference room. Only one target field should be provided in the request body — user_id, ivr_id, or conference_id. The number must already be provisioned in your team. Reassigning a number immediately changes call routing for that number.

Permission: Numbers Read required (assignment uses read-level permission).

Monitoring impact:

  • OFF: Limited assignment capabilities — restricted to your own numbers.
  • ON: Full assignment capabilities across the entire team.
patch/numbers/{number}

Path parameters

numberinteger required

The phone number to assign, in E.164 format without the + prefix (e.g., 33612345678).

Request body

user_idinteger

The user ID to assign the number to.

ivr_idinteger

The IVR ID to assign the number to.

conference_idinteger

The conference ID to assign the number to.

Response

Number successfully assigned