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

# Delete Voice

> Deletes a voice.

A voice still referenced by a PAL or a face is **not** deleted: the request returns `409` with a `used_by` count of each, so you can repoint them and retry. A face's `original_voice_id` cannot be deleted at all, since it is the id a face reverts to.


<Info>
  For AI agents, use `https://docs.tavus.io/openapi.yaml` for the full HTTP API contract.
</Info>


## OpenAPI

````yaml delete /v2/voices/{voice_id}
openapi: 3.0.3
info:
  title: Tavus Developer API Collection
  version: 1.0.0
  contact: {}
servers:
  - url: https://tavusapi.com
security:
  - apiKey: []
tags:
  - name: Videos
  - name: Faces
  - name: Voices
  - name: Conversations
  - name: Deployments
  - name: PALs
  - name: Tools
  - name: PAL Tools
  - name: Pronunciation Dictionaries
  - name: Replacements
  - name: Transcriptions
  - name: Documents
paths:
  /v2/voices/{voice_id}:
    delete:
      tags:
        - Voices
      summary: Delete Voice
      description: >
        Deletes a voice.


        A voice still referenced by a PAL or a face is **not** deleted: the
        request returns `409` with a `used_by` count of each, so you can repoint
        them and retry. A face's `original_voice_id` cannot be deleted at all,
        since it is the id a face reverts to.
      operationId: deleteVoice
      parameters:
        - name: voice_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '204':
          description: NO CONTENT
        '401':
          description: UNAUTHORIZED
        '404':
          description: NOT FOUND
        '409':
          description: 'CONFLICT: the voice is still in use, or is a face''s original voice.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: This voice is still in use by a face or pal
                  used_by:
                    type: object
                    description: How many faces and pals still point at this voice.
                    properties:
                      faces:
                        type: integer
                        example: 1
                      pals:
                        type: integer
                        example: 0
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````