numbers

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

Changed on

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}

Request

  • Base URL
    https://public-api.ringover.com/v2
  • URL
    https://public-api.ringover.com/v2/numbers/{number}
  • Auth
    API key in header Authorization

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

Changes