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

# Get a Kling voice operation

> Check whether a cloned voice is ready to use or its deletion has completed.

Pass the `operationId` returned by [create](https://docs.gengen.farm/api-reference/kling/4.0/create-voice.md) or [delete](https://docs.gengen.farm/api-reference/kling/4.0/delete-voice.md), using an API key from the same workspace. Polling is free. HTTP 200 means the lookup succeeded. Read `status` to determine the outcome.

| Status | What to do |
| - | - |
| `pending` | Creation is still running. Poll again with the same `operationId`. |
| `active` | Copy the string `voiceId` into your [Omni request](https://docs.gengen.farm/api-reference/kling/4.0/voices.md). Open `previewUrl` to hear the sample when available. If a deletion failed, the voice returns to this state and `message` explains why. |
| `failed` | Creation failed. Read `message` for details. |
| `deleting` | Keep polling. The voice still occupies a slot. |
| `deleted` | Deletion is confirmed and the slot has been released. |


## OpenAPI

````yaml openapi/kling-40-video.yaml GET /video/kling/voice-operations/{operationId}
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/voice-operations/{operationId}:
    get:
      summary: Get a voice operation
      description: Free status check for a private voice in the current workspace.
      operationId: getKlingVoiceOperation
      parameters:
        - name: operationId
          in: path
          required: true
          description: >-
            UUID returned by voice creation or deletion. Keep this ID for
            polling.
          schema:
            type: string
            format: uuid
          example: 638f14d6-81ba-49f7-8c21-a16f34dca78f
      responses:
        '200':
          description: >-
            Current state, including pending or deleting. An active voice can be
            used in Omni.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceOperation'
              examples:
                active:
                  $ref: '#/components/examples/ActiveVoice'
        '401':
          $ref: '#/components/responses/VoiceUnauthorized'
        '404':
          description: Unknown operation or operation outside this workspace.
components:
  schemas:
    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.
    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.
    VoicePreviewUrl:
      type: string
      format: uri
      description: Optional HTTPS link to an audio preview. Open it to listen to the voice.
  examples:
    ActiveVoice:
      value:
        operationId: 638f14d6-81ba-49f7-8c21-a16f34dca78f
        status: active
        name: Narrator
        voiceId: '839000000000000001'
        previewUrl: https://example.com/narrator-preview.wav
  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.