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

# Delete Voice

> Permanently delete a voice you own.

## Overview

Soft-deletes a voice from your library. The voice's `deleted_at` column is stamped and it stops appearing in [List Voices](https://docs.bland.ai/api-v1/get/voices.md) and synthesis flows.

Only voices owned by your org can be deleted; curated default voices, voices in the public library you have not added, and voices owned by other orgs return `400 ERROR_DELETING_VOICE`.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Path Parameters

**id** `string` *required*

UUID of the voice to delete.

***

## Response

**data** `object`

Confirmation that the voice was deleted.

**Fields**

**status** `string`

`success` on success.

**message** `string`

Human-readable confirmation, for example `"Voice deleted successfully"`.

**errors** `null | array`

`null` on success.

```json Response theme={null}
{
  "data": {
    "status": "success",
    "message": "Voice deleted successfully"
  },
  "errors": null
}
```

```json Error Deleting Voice theme={null}
{
  "data": null,
  "errors": [
    { "error": "ERROR_DELETING_VOICE", "message": "Error deleting voice" }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.