---
title: "delete voice"
method: DELETE
path: "/v1/voices/{id}"
tags: ["Voices"]
---

# delete voice

`DELETE /v1/voices/{id}`

Delete a voice by ID. The voice is soft-deleted locally and then removed at the TTS provider. When active personas (or their working drafts) still use the voice, the request is refused with 409 because deleting the voice would silence those personas' sessions. Move the impacted personas to another voice (PUT /v1/personas/{id}), then retry.

## Path parameters

- `id` string, uuid, required

## Response `200`

Successfully deleted voice

- object
  - `message` string

## Other responses

- `400` — Bad request - Invalid voice ID
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - API key lacks the required permission
- `404` — Not Found - Voice not found
- `409` — Conflict - the voice is still used by active personas. Move those personas to another voice, then retry.
- `500` — Server error

---

[API](https://skmtc.net/anam/apis/anam-ai-api.md) · [All operations](https://skmtc.net/anam/apis/anam-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anam/anam-ai-api/revisions/67afd1c5db59/schema)