Switch a number between dialer and voice AI
PATCH /phone-numbers/update-capabilities
Change what a number is for, and re-provision it to match.
This reaches the voice platform: the LiveKit trunks and the carrier
voice_url are re-pointed so inbound calls arrive where the new capability
says they should. A number is briefly answering neither while that happens.
The two flags are not independent. dialer set with voice unset means
dialer; every other combination means voice AI - which is the app’s own
derivation, mirrored rather than reinvented.
Admin-only for the same reason as update-assignee.
Authorizations
Parameters
Header Parameters
Request Body required
Switch a number between dialer and voice-AI answering.
Mirrors phone_numbers.interfaces.fastapi.dtos.UpdateCapabilitiesRequest.
The two flags are not independent in effect: the app derives the voice
service’s inbound_type as dialer only when dialer is set and voice
is not, and ai in every other combination.
object
Use the number for outbound dialing.
The number to reconfigure, E.164.
Answer inbound calls with a voice AI agent.
Responses
200
Successful Response
object
An open envelope for a purchase result, a release, or an A2P job.
Open on purpose. A purchase returns the stored row (whose capability and
provider-metadata keys differ per provider), a workflow start returns a
workflow_id, and the A2P reconcile returns per-number outcomes that grow
as carriers add statuses. Pinning it would silently drop whatever the
provider reported that this contract had not caught up on.
object
object
Whether there are more pages
Items per page
Current page number (1-indexed)
Total number of items
422
Validation Error