Skip to main content
GET
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. On failed, read message if present.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

operationId
string<uuid>
required

The operationId returned for a pending clone or save.

Response

Current creation status. Use the returned voiceId when active.

name
string
required
kind
enum<string>
required
Available options:
clone,
design
status
enum<string>
required
Available options:
creating,
reconciling,
active,
verificationRequired,
failed,
deleting,
deleted
models
string[]
required
operationId
string<uuid>

Creation tracking ID returned while pending.

statusUrl
string

Relative URL for polling a pending creation with the workspace API key.

id
string

Same as voiceId once the voice has an ID.

voiceId
string

Same value as id. Use for speech and dialogue when active.

message
string

Optional provider explanation on a failed or reconciling private voice. Use status to determine the outcome.