---
title: "Delete Voice"
api: "DELETE /v1/api/voices/{id}"
description: "Delete a custom voice from your workspace."
lastUpdated: "2026-11-04"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

## Headers
<ParamField header="x-workspace-id" type="string" required>
Workspace identifier for the API.
</ParamField>

## Path Parameters

<ParamField path="id" type="string" required>
The custom voice's `id`, as returned by [Create Custom Voice](https://trillet-ai.jamdesk.app/v1/api-reference/endpoints/voices/create) or [List Custom Voices](https://trillet-ai.jamdesk.app/v1/api-reference/endpoints/voices/list-custom). Only custom voices created in this workspace can be deleted; catalog voices from Search Voices can't.
</ParamField>

## Response Fields

<ResponseField name="success" type="boolean">
Whether the deletion was successful.
</ResponseField>

## Errors

| Status | Body | When |
| --- | --- | --- |
| `400` | `{"error": "Workspace ID is required"}` | No `x-workspace-id` |
| `404` | `{"error": "Voice not found or doesn't belong to this workspace"}` | The ID isn't a custom voice of this workspace |
| `500` | `{"error": "..."}` | Anything else |

Agents that still use a deleted voice are not updated. Give them another voice first.

<ResponseExample>
```json
{
  "success": true
}
```
</ResponseExample>


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
