---
title: "Reassign Phone To Agent"
method: PATCH
path: "/v1/smb/phone-numbers/assignments/{phone_assignment_id}"
tags: ["smb", "SMB"]
---

# Reassign Phone To Agent

`PATCH /v1/smb/phone-numbers/assignments/{phone_assignment_id}`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/smb/phone-numbers/assignments/{phone_assignment_id}`
- Auth: none declared

Move a phone number to a different receptionist in the same workspace, which answers its calls from then on. Returns 409 `phone_number_not_attached` for a number no receptionist answers yet (attach it with `POST /v1/smb/phone-numbers/assignments`), and 403 `telephony_managed_by_reseller` when the reseller supplies the workspace's numbers from its own Twilio account.

## Path parameters

- `phone_assignment_id` string, required

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.
- `xi-workspace-id` string, nullable: The customer workspace a reseller's API key acts on.

## Request body

- ReassignPhoneRequest: Body for attaching a phone number to a different receptionist.
  - `customer_facing_agent_id` string, required: The receptionist that answers calls to the number from now on.

## Response `200`

Successful Response

- SMBPhoneAssignmentDBModel: Persisted phone assignment; see ``SMBPhoneAssignmentBase`` for field semantics.
  - `phone_number` string
  - `is_byo` boolean: True when the phone is bring-your-own: registered by the workspace using their own telephony provider (Twilio credentials or SIP trunk). BYO phones are never part of the shared pool, do not count against the tier-based phone quota, and are deleted (rather than returned to the pool) on release.
  - `provider` 'twilio' | 'sip_trunk': Telephony provider for this phone number. Defaults to twilio for backwards compatibility with existing documents.
  - `nanp_area_code` integer: US/Canada NANP area code (NPA) as an integer.
  - `customer_facing_agent_id` string, nullable: Determines assignment status: None = pool (unassigned), non-None = assigned to this customer-facing agent. When set, inbound calls to this phone route to that agent.
  - `deactivated_at_unix` integer, nullable: Unix timestamp when this assignment was deactivated. Drives the per-assignment 14-day grace cleanup. None when active.
  - `deactivation_reason` 'tier_downgrade' | 'no_entitlement' | 'user': Why a phone assignment is currently inactive.
  - `regulatory_status` 'held' | 'approved': Regulatory standing of a number in a country that requires paperwork. Absent (``None``) on numbers from countries with no requirements, which is every pooled US/Canada number — those are usable the moment they are bought.
  - `regulatory_number_type` 'local' | 'mobile': Which kind of regulated number a request or an issued number is for. Lives here rather than next to the application model because a phone assignment records it too, and the assignment model cannot import from ``telephony.models`` without a cycle back into this module.
  - `regulatory_country` string
  - `_id` string, required
  - `created_at_unix` integer: Unix timestamp (seconds since epoch)
  - `updated_at_unix` integer: Unix timestamp (seconds since epoch)
  - `is_active` boolean, required
  - `accepts_public_calls` boolean, required: Whether inbound calls from the public may reach the agent.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-30** `b77988199a2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/smb/phone-numbers/assignments/:phone_assignment_id/patch.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/b402c33b07b4?raw)