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

# delete voice

> 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.



## OpenAPI

````yaml https://api.anam.ai/swagger.json delete /v1/voices/{id}
openapi: 3.1.0
info:
  title: Anam AI API
  version: '1.0'
servers:
  - url: https://api.anam.ai
    description: Anam API
security:
  - BearerAuth: []
tags:
  - name: Sessions
  - name: Meetings
  - name: Personas
  - name: Avatars
  - name: Voices
  - name: LLMs
  - name: Knowledge
  - name: Tools
  - name: Share Links
  - name: Engine
paths:
  /v1/voices/{id}:
    delete:
      tags:
        - Voices
      summary: delete voice
      description: >-
        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.
      operationId: deleteVoice
      parameters:
        - in: path
          name: id
          schema:
            type: string
            format: uuid
          required: true
          description: Voice ID
      responses:
        '200':
          description: Successfully deleted voice
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Voice deleted successfully
        '400':
          description: Bad request - Invalid voice ID
        '401':
          description: Unauthorized - Invalid or missing API key
        '403':
          description: Forbidden - API key lacks the required permission
        '404':
          description: Not Found - Voice not found
        '409':
          description: >-
            Conflict - the voice is still used by active personas. Move those
            personas to another voice, then retry.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Voice is used by active personas. Move them to another
                      voice before deleting it.
                  impactedPersonaIds:
                    type: array
                    items:
                      type: string
                      format: uuid
        '500':
          description: Server error
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````