Update Voice
Update the name, description, gender, and accent of a voice. To set the gender back to the default, set the gender to null. If gender is not specified, the gender will not be updated.
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 ID of the voice. Find one in the Voice Library or via List Voices.
Body
The name of the voice.
A few words describing the voice. At most 32 characters.
A description for the voice, typically longer than the tagline if both are provided.
masculine, feminine, gender_neutral Catalog accent id from GET /accents (e.g. southern-us). Display names are rejected.
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 "southern-us"
Controls who can access this resource. Prefer "public" | "private". Deprecated nested { "type": "public" | "private" } is still accepted.
private, public Response
The ID of the voice. Find one in the Voice Library or via List Voices.
Whether your organization owns the voice.
Who can use the resource. private means only the owner can use the resource. public means everyone can use the resource.
private, public The display name of the voice. Does not include the tagline.
A short descriptor for the voice (at most 32 characters). Empty string when unset.
A description for the voice, typically longer than the tagline if both are provided.
The date and time the voice was created.
Deprecated. Prefer locales[].locale (BCP-47). ISO 639-1 language code (e.g. en, fr, zh).
"en"
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).
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.
owner, all The gender of the voice, if specified.
masculine, feminine, gender_neutral Catalog accent id from GET /accents (e.g. southern-us). Display names are not returned on this API version.
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 "southern-us"
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.
Deprecated. Prefer locales[].locale (BCP-47). ISO 3166-1 alpha-2 country code when available (e.g. US, GB, FR).
"US"
Whether this voice is a pro voice clone.