> ## 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](/api-v1/get/voices) 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

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

***

## Path Parameters

<ParamField path="id" type="string" required>
  UUID of the voice to delete.
</ParamField>

***

## Response

<ResponseField name="data" type="object">
  Confirmation that the voice was deleted.

  <Expandable title="Fields">
    <ResponseField name="status" type="string">
      `success` on success.
    </ResponseField>

    <ResponseField name="message" type="string">
      Human-readable confirmation, for example `"Voice deleted successfully"`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="errors" type="null | array">
  `null` on success.
</ResponseField>

<ResponseExample>
  ```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" }
    ]
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)