Update Provider
Update a provider. To ensure assigned numbers are reachable, Twilio credentials are validated before saving. If the new credentials are invalid, the request fails and returns a list of unreachable numbers currently assigned to agents. For SIP trunks, omitted fields remain unchanged. Set credentials or destination_country to null to clear that field. Send [] to clear an inbound allowlist.
Authorizations
Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.
Headers
API version header.
2026-08-14 "2026-08-14"
Path Parameters
The provider ID.
Body
- Twilio
- SIP Trunk
Update Twilio API key credentials and optionally the region. Cartesia validates the credentials and rejects the update with a list of unreachable numbers assigned to agents.
Must be "twilio".
twilio New Twilio API key SID.
New API key secret.
The Twilio region the phone number and API key are configured for. us1 (US), ie1 (Ireland), au1 (Australia). Default is us1.
us1, ie1, au1 Response
Provider updated.
- Twilio
- SIP Trunk
A linked Twilio account. The api_key_sid field is partially masked in responses.
Always "twilio".
twilio Unique identifier for the provider.
The Twilio account SID.
The Twilio API key SID (partially masked).
The Twilio region the phone number and API key are configured for. us1 (US), ie1 (Ireland), au1 (Australia). Default is us1.
us1, ie1, au1 A human-readable label for the provider.