Skip to main content
GET
Get a voice operation
Pass the operationId returned by create or delete, using an API key from the same workspace. Polling is free. HTTP 200 means the lookup succeeded. Read status to determine the outcome.

Authorizations

Authorization
string
header
required

GENGEN API key

Path Parameters

operationId
string<uuid>
required

UUID returned by voice creation or deletion. Keep this ID for polling.

Response

Current state, including pending or deleting. An active voice can be used in Omni.

operationId
string<uuid>
required

Stable workspace voice operation ID. Use it in the voice-operations path to check progress.

status
enum<string>
required

Pending and deleting require polling. Active means ready for Omni, failed means creation failed, and deleted confirms removal.

Available options:
pending,
active,
failed,
deleting,
deleted
name
string
required

Display name supplied at creation.

voiceId
string

Returned when active. Copy this string into an Omni request or the delete endpoint.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_-]+$
previewUrl
string<uri>

Optional HTTPS link to an audio preview. Open it to listen to the voice.

message
string

Additional detail about a failure or a deletion awaiting confirmation.