Update Phone Number
Update a phone number’s label, agent assignment, or provider
Authorizations
Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.
Headers
Body
Fields to update on a phone number. All fields are optional. Set agent_id to null to unassign the current agent.
Change the provider. Pass { "id": "..." } for an existing provider, or pass Twilio account fields for lookup convenience. For Twilio, the phone number must exist in the target provider account. For SIP trunk providers, Cartesia handles reassignment between SIP providers. Switching between provider types is not supported; delete and re-import the number instead.
- By ID
- By Twilio Account
Response
Phone number updated.
A phone number with its provider and agent assignment details.