> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telzino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Custom Voice

> Delete a cloned voice (blocked while in use)

Deletes a custom (cloned) voice from the organization and from Cartesia.
Deletion is **blocked while any agent in the organization still uses the voice** —
reassign those agents first.

## Path Parameters

<ParamField path="voiceId" type="string" required>
  The voice id returned by [Create](/api-reference/custom-voices/create) / [List](/api-reference/custom-voices/list) (the Cartesia voice id). The internal `custom_voices` row id is also accepted.
</ParamField>

## Query Parameters

<ParamField query="organizationId" type="string" required>
  The organization that owns the voice.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.telzino.com/v1/custom-voices/ROW_ID?organizationId=ORG_UUID" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  { "success": true }
  ```

  ```json 409 In use theme={null}
  {
    "error": "Voice is in use by one or more agents. Reassign them before deleting.",
    "agents": [{ "id": "agent-uuid", "name": "Front Desk" }]
  }
  ```
</ResponseExample>

## Errors

| Status | Meaning                                               |
| ------ | ----------------------------------------------------- |
| `400`  | `organizationId` is missing                           |
| `404`  | Organization or voice not found                       |
| `409`  | Voice is in use; response includes the using `agents` |