Skip to main content
DELETE
Delete a private voice
Choose the voiceId from List voices 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. If the operation is still awaiting confirmation after 30 minutes, contact support with that ID. If a deletion fails, the voice returns to active.

Authorizations

Authorization
string
header
required

GENGEN API key

Path Parameters

voiceId
string
required

String ID from your private voice directory. Use an API key from the owning workspace. Kling's voice ID. Preserve it as a string, including when it contains only digits. Pass it in assets.voices[].voiceId.

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

Response

Current voice state. A deleted status confirms removal.

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.