Skip to main content
PATCH
Update Voice

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 ID of the voice. Find one in the Voice Library or via List Voices.

Body

application/json
name
string

The name of the voice.

tagline
string

A few words describing the voice. At most 32 characters.

description
string

A description for the voice, typically longer than the tagline if both are provided.

gender
enum<string> | null
Available options:
masculine,
feminine,
gender_neutral
accent
enum<string> | null

Catalog accent id from GET /accents (e.g. southern-us). Display names are rejected.

Available options:
abruzzo-italian,
african-american,
african-french,
arabic,
arabic-english,
australian,
bagheli,
belgian-french,
brazilian-portuguese,
british,
budapest,
bulgarian,
california,
camba,
campania,
canadian-english,
canadian-french,
castilian,
central-tamil,
central-thai,
central-vietnamese,
chilean,
colombian,
czech,
danish,
european-portuguese,
finnish,
general-american,
high-german,
hindi,
indian-english,
indian-urdu,
irish,
israeli,
istanbul,
italian,
jakarta,
japanese,
jessore,
khaleeji,
konkani,
korean,
kyiv,
malay,
mandarin,
manila,
mexican,
middle-eastern-arabic,
midwestern-american,
modern-standard-arabic,
moldovan,
new-york,
new-zealand,
north-kerala,
odia,
oslo,
parisian,
parsi,
peruvian,
polish,
powadhi,
randstad,
romanian,
russian,
singaporean,
slovak,
south-african,
southern-us,
southern-karnataka,
southern-vietnamese,
standard-japanese,
stockholm,
swiss-standard,
taiwanese-mandarin,
tbilisi,
telangana,
urdu,
thessaloniki,
zagreb
Example:

"southern-us"

access

Controls who can access this resource. Prefer "public" | "private". Deprecated nested { "type": "public" | "private" } is still accepted.

Available options:
private,
public

Response

200 - application/json
id
string
required

The ID of the voice. Find one in the Voice Library or via List Voices.

is_owner
boolean
required

Whether your organization owns the voice.

access
enum<string>
required

Who can use the resource. private means only the owner can use the resource. public means everyone can use the resource.

Available options:
private,
public
name
string
required

The display name of the voice. Does not include the tagline.

tagline
string
default:""
required

A short descriptor for the voice (at most 32 characters). Empty string when unset.

description
string
required

A description for the voice, typically longer than the tagline if both are provided.

created_at
string<date-time>
required

The date and time the voice was created.

language
string
required
deprecated

Deprecated. Prefer locales[].locale (BCP-47). ISO 639-1 language code (e.g. en, fr, zh).

Example:

"en"

locales
object[]
required

Locales this voice can speak. The native/source locale is first (is_native: true), followed by attached cross-lingual locales. Locale codes are BCP-47 language-region tags (for example en-US, es-MX).

Example:
visibility
enum<string>
required

When the resource is returned by the list endpoint. owner means the resource appears for the owner only. all means the resource appears for all users.

Available options:
owner,
all
gender
enum<string> | null

The gender of the voice, if specified.

Available options:
masculine,
feminine,
gender_neutral
accent
enum<string> | null

Catalog accent id from GET /accents (e.g. southern-us). Display names are not returned on this API version.

Available options:
abruzzo-italian,
african-american,
african-french,
arabic,
arabic-english,
australian,
bagheli,
belgian-french,
brazilian-portuguese,
british,
budapest,
bulgarian,
california,
camba,
campania,
canadian-english,
canadian-french,
castilian,
central-tamil,
central-thai,
central-vietnamese,
chilean,
colombian,
czech,
danish,
european-portuguese,
finnish,
general-american,
high-german,
hindi,
indian-english,
indian-urdu,
irish,
israeli,
istanbul,
italian,
jakarta,
japanese,
jessore,
khaleeji,
konkani,
korean,
kyiv,
malay,
mandarin,
manila,
mexican,
middle-eastern-arabic,
midwestern-american,
modern-standard-arabic,
moldovan,
new-york,
new-zealand,
north-kerala,
odia,
oslo,
parisian,
parsi,
peruvian,
polish,
powadhi,
randstad,
romanian,
russian,
singaporean,
slovak,
south-african,
southern-us,
southern-karnataka,
southern-vietnamese,
standard-japanese,
stockholm,
swiss-standard,
taiwanese-mandarin,
tbilisi,
telangana,
urdu,
thessaloniki,
zagreb
Example:

"southern-us"

preview_file_url
string | null

A URL to download a preview audio file for this voice. Useful to avoid consuming credits when looking for the right voice. The URL requires the same Authorization header. Voice previews may be changed, moved, or deleted so you should avoid storing the URL permanently. This property will be null if there's no preview available. Only included when expand[] includes preview_file_url.

country
string | null
deprecated

Deprecated. Prefer locales[].locale (BCP-47). ISO 3166-1 alpha-2 country code when available (e.g. US, GB, FR).

Example:

"US"

is_pro
boolean

Whether this voice is a pro voice clone.