Update Voice
Update the name, description, and gender 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-03-01 "2026-03-01"
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 Change who can access the voice
Response
The ID of the voice. Find one in the Voice Library or via List Voices.
Whether your organization owns the voice.
Who can access and list the voice
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.
The voice's language, as an ISO 639-1 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).
Use access instead. Whether the voice is publicly accessible.
The gender of the voice, if specified.
masculine, feminine, gender_neutral 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.
The country associated with the voice, as an ISO 3166-1 alpha-2 code when available.
"US"
Whether this voice is a pro voice clone.
No longer used.