---
title: "Assign a phone number to a user, IVR, or conference"
method: PATCH
path: "/numbers/{number}"
tags: ["numbers"]
---

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

`PATCH /numbers/{number}`

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.

## Path parameters

- `number` integer, required

## Request body

- object
  - `user_id` integer — The user ID to assign the number to.
  - `ivr_id` integer — The IVR ID to assign the number to.
  - `conference_id` integer — The conference ID to assign the number to.

## Response `200`

Number successfully assigned

## Other responses

- `400` — Invalid request — check number format and assignment target
- `401` — Unauthorized — invalid API key or missing `Numbers Read` permission
- `404` — Number not found
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)