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

# Delete Custom Voice

> Soft-delete a custom voice that was created via `POST /v1/voices/clone`. The voice is removed from your active set and the corresponding `custom_voice_slot` becomes available for a new clone.

After deletion, the same `voice_id` returns 404 on subsequent requests. Only the owner of the voice may delete it; other users receive 404.

Returns 204 No Content on success.



## OpenAPI

````yaml /api-reference/openapi.json delete /v1/voices/{voice_id}
openapi: 3.1.0
info:
  title: Typecast API
  version: 0.1.2
  x-logo:
    url: https://typecast.ai/_ipx/_/image/logo/tc_logo.webp
servers:
  - url: https://api.typecast.ai
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /v1/voices/{voice_id}:
    delete:
      tags:
        - Voices
      summary: Delete Custom Voice
      description: >-
        Soft-delete a custom voice that was created via `POST /v1/voices/clone`.
        The voice is removed from your active set and the corresponding
        `custom_voice_slot` becomes available for a new clone.


        After deletion, the same `voice_id` returns 404 on subsequent requests.
        Only the owner of the voice may delete it; other users receive 404.


        Returns 204 No Content on success.
      operationId: delete_custom_voice_v1_voices__voice_id__delete
      parameters:
        - name: voice_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^uc_[A-Za-z0-9]+$
            example: uc_64a1b2c3d4e5f6a7b8c9d0e1
          description: Custom voice identifier with the `uc_` prefix.
      responses:
        '204':
          description: >-
            No Content - Voice deleted successfully. The response body is
            intentionally empty per RFC 9110; treat any 2xx status as success.
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Invalid API key
        '404':
          description: Not Found - Voice does not exist or is not owned by the caller
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Voice not found
        '422':
          description: Validation Error - Invalid voice_id format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Invalid request format
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Error message describing the issue
      required:
        - detail
      example:
        detail: An error occurred processing the request
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        API key for authentication. You can obtain an API key from the Typecast
        API Console.

````