Skip to main content
PATCH
Update Provider

Authorizations

Authorization
string
header
default:$CARTESIA_API_KEY
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

Cartesia-Version
enum<string>
default:2026-03-01
required

API version header.

Available options:
2026-03-01
Example:

"2026-03-01"

Path Parameters

id
string
required

The provider ID.

Body

application/json

Update Twilio API key credentials and optionally the region. Credentials are validated before applying. If phone numbers using this provider cannot be verified with the new credentials, the update is rejected with a list of unreachable numbers.

type
enum<string>
required

Must be "twilio".

Available options:
twilio
api_key_sid
string
required

New Twilio API key SID.

api_key_secret
string<password>
required

New API key secret.

region
enum<string>
default:us1

The Twilio region the phone number and API key are configured for. us1 (US), ie1 (Ireland), au1 (Australia). Default is us1.

Available options:
us1,
ie1,
au1

Response

Provider updated.

A linked Twilio account. The api_key_sid field is partially masked in responses.

type
enum<string>
required

Always "twilio".

Available options:
twilio
id
string
required

Unique identifier for the provider.

account_sid
string
required

The Twilio account SID.

api_key_sid
string
required

The Twilio API key SID (partially masked).

region
enum<string>
default:us1
required

The Twilio region the phone number and API key are configured for. us1 (US), ie1 (Ireland), au1 (Australia). Default is us1.

Available options:
us1,
ie1,
au1
label
string | null

A human-readable label for the provider.