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-08-14
required

API version header.

Available options:
2026-08-14
Example:

"2026-08-14"

Path Parameters

id
string
required

The provider ID.

Body

application/json

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.

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.