## TL;DR
A Cartesia "Voice not found" error means the voice UUID you sent does not exist under the account your API key belongs to. List voices with that same key and compare UUIDs character for character. A voice that exists on someone else's account, a demo voice from the docs, or a stale id from a deleted voice all fail the same way.

```text
cartesia Voice not found error when calling TTS
```

## Use this when
- Cartesia TTS returns a provider error saying the voice was not found.
- The voice id looks correct but every request fails.
- You copied a voice id from docs, a demo, or another project.
- A voice that used to work started failing after account changes.

## Not for this skill when
- The error is 401 invalid API key. That is an authentication problem, not a voice problem.
- The error is an unsupported sample rate. That is a configuration problem.
- The websocket never connects at all. That is a connection problem.

## Steps
1. List voices with the exact key you use for TTS and find the UUID you are sending. Verify: you can see the UUID in the list, letter for letter.
2. Check the id you are actually sending in the request body (voice mode id, id field). Verify: it matches one UUID from step 1 exactly, no extra whitespace or quotes.
3. If the id came from docs or a shared example, replace it with a UUID from your own account's voice list or the Cartesia voice library under your login. Verify: a test TTS request with the new id returns audio.
4. If a voice that used to work now fails, check whether it was deleted or the key was moved to a different team. Verify: the voice list explains the absence, or a recreated voice works.

Expected output of each step is named above. The final check is a TTS request that returns audio bytes instead of the voice error.

## Root cause, briefly
Voice ids are scoped to accounts. Cartesia resolves the id against the key's account, so a valid-looking UUID from anywhere else is the same as a typo.

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_Mj61rf6STxhjzMuT34KwFQ
