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

# Check a pending voice creation

After a clone or save returns HTTP 202, send GET to its `statusUrl` with a key in the same workspace. Keep polling while the operation is `creating` or `reconciling`.

On `active`, use the returned `voiceId`. For `verificationRequired`, follow the [verification instructions](https://docs.gengen.farm/api-reference/elevenlabs/get-voice.md). On `failed`, read `message` if present.


## OpenAPI

````yaml openapi/audio.yaml GET /audio/voice-operations/{operationId}
openapi: 3.1.0
info:
  title: GENGEN Audio API
  version: 1.0.0
  description: >-
    Speech, dialogue, voice design, workspace voices, realtime sessions and
    completion webhooks.
servers:
  - url: https://gengen.farm/api/gengen/v1
security:
  - bearerAuth: []
paths:
  /audio/voice-operations/{operationId}:
    get:
      tags:
        - Voices
      summary: Check a pending voice creation
      operationId: audio-get-voice-operation
      parameters:
        - name: operationId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The operationId returned for a pending clone or save.
      responses:
        '200':
          description: Current creation status. Use the returned voiceId when active.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateVoice'
        '404':
          description: Operation unavailable in this workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PrivateVoice:
      type: object
      required:
        - name
        - kind
        - status
        - models
      properties:
        operationId:
          type: string
          format: uuid
          description: Creation tracking ID returned while pending.
        statusUrl:
          type: string
          description: >-
            Relative URL for polling a pending creation with the workspace API
            key.
        id:
          type: string
          description: Same as voiceId once the voice has an ID.
        voiceId:
          type: string
          description: Same value as id. Use for speech and dialogue when active.
        name:
          type: string
        kind:
          type: string
          enum:
            - clone
            - design
        status:
          type: string
          enum:
            - creating
            - reconciling
            - active
            - verificationRequired
            - failed
            - deleting
            - deleted
        message:
          type: string
          description: >-
            Optional provider explanation on a failed or reconciling private
            voice. Use status to determine the outcome.
        models:
          type: array
          items:
            type: string
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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