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

# Delete a private Kling voice

> Remove a voice owned by your workspace and release its slot.

Choose the `voiceId` from [List voices](https://docs.gengen.farm/api-reference/kling/4.0/voices.md) with `scope=private`. Send it as a string with an API key from the owning workspace. Sending this request in Try it deletes the selected voice. Deletion is free.

On HTTP 200 with `status: deleted`, the voice has been removed and its slot is available. On HTTP 202 with `status: deleting`, the voice is unavailable for new generations and still occupies a slot. Use the returned `operationId` to [check the deletion](https://docs.gengen.farm/api-reference/kling/4.0/get-voice-operation.md). If the operation is still awaiting confirmation after 30 minutes, contact support with that ID. If a deletion fails, the voice returns to `active`.


## OpenAPI

````yaml openapi/kling-40-video.yaml DELETE /video/kling/voices/{voiceId}
openapi: 3.1.0
info:
  title: Kling 4.0 Video API
  version: 1.0.0
  description: >-
    Supports text-to-video, image keyframes and Omni references/editing.
    Authenticate with a GENGEN API key.
servers:
  - url: https://gengen.farm/api/gengen/v1
security:
  - bearerAuth: []
paths:
  /video/kling/voices/{voiceId}:
    delete:
      summary: Delete a private voice
      description: Free deletion. The slot is released once status is deleted.
      operationId: deleteKlingVoice
      parameters:
        - name: voiceId
          in: path
          required: true
          description: >-
            String ID from your private voice directory. Use an API key from the
            owning workspace.
          schema:
            $ref: '#/components/schemas/VoiceId'
      responses:
        '200':
          description: Current voice state. A deleted status confirms removal.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceOperation'
              example:
                operationId: 638f14d6-81ba-49f7-8c21-a16f34dca78f
                status: deleted
                name: Narrator
        '202':
          description: Deletion is awaiting confirmation. Poll the returned operationId.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceOperation'
              example:
                operationId: 638f14d6-81ba-49f7-8c21-a16f34dca78f
                status: deleting
                name: Narrator
        '401':
          $ref: '#/components/responses/VoiceUnauthorized'
        '404':
          description: Unknown voice or voice outside this workspace.
        '502':
          description: Kling rejected the deletion or confirmed it failed.
components:
  schemas:
    VoiceId:
      type: string
      minLength: 1
      maxLength: 128
      pattern: ^[A-Za-z0-9_-]+$
      description: >-
        Kling's voice ID. Preserve it as a string, including when it contains
        only digits. Pass it in assets.voices[].voiceId.
    VoiceOperation:
      type: object
      required:
        - operationId
        - status
        - name
      properties:
        operationId:
          type: string
          format: uuid
          description: >-
            Stable workspace voice operation ID. Use it in the voice-operations
            path to check progress.
        status:
          type: string
          enum:
            - pending
            - active
            - failed
            - deleting
            - deleted
          description: >-
            Pending and deleting require polling. Active means ready for Omni,
            failed means creation failed, and deleted confirms removal.
        name:
          type: string
          description: Display name supplied at creation.
        voiceId:
          $ref: '#/components/schemas/VoiceId'
          description: >-
            Returned when active. Copy this string into an Omni request or the
            delete endpoint.
        previewUrl:
          $ref: '#/components/schemas/VoicePreviewUrl'
        message:
          type: string
          description: >-
            Additional detail about a failure or a deletion awaiting
            confirmation.
    VoicePreviewUrl:
      type: string
      format: uri
      description: Optional HTTPS link to an audio preview. Open it to listen to the voice.
  responses:
    VoiceUnauthorized:
      description: A valid GENGEN bearer API key is required.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: GENGEN API key

````

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