For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
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/reception/phone-numbers/assignments).
Parametri di percorso
phone_assignment_idstringObbligatorio
Header
xi-api-keystringOpzionale
xi-workspace-idstring or nullOpzionale
The customer workspace a reseller's API key acts on.
Richiesta
This endpoint expects an object.
customer_facing_agent_idstringObbligatorio
The receptionist that answers calls to the number from now on.
Risposta
Risposta riuscita
_idstring
is_activebooleanSola lettura
accepts_public_callsbooleanSola lettura
Whether inbound calls from the public may reach the receptionist.
phone_numberstring or nullOpzionale
Phone number in E.164 format.
is_byobooleanOpzionalePredefinito a false
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 plan’s phone number limit, and are deleted (rather than returned to the pool) on release.
providerenumOpzionalePredefinito a twilio
Telephony provider for this phone number.
Valori consentiti:
nanp_area_codeintegerOpzionalePredefinito a 0
US/Canada NANP area code (NPA) as an integer.
customer_facing_agent_idstring or nullOpzionale
The receptionist that answers this number. Null when the workspace holds the number but no receptionist answers it yet.
deactivated_at_unixinteger or nullOpzionale
Unix timestamp when this number was deactivated; it is released 14 days later. Null when active.
deactivation_reasonenum or nullOpzionale
Why this number was deactivated. Null when active.
Valori consentiti:
regulatory_statusenum or nullOpzionale
Null for numbers that need no paperwork. held while the workspace’s own application is under review, approved once it passed and the number is fully usable.
Valori consentiti:
regulatory_number_typeenum or nullOpzionale
The regulated number type this number was issued as. Null for numbers that need no paperwork.
Valori consentiti:
regulatory_countrystring or nullOpzionale
ISO country the regulated number was issued in. Null for numbers that need no paperwork.
