Skip to navigation

List supported voices

Returns currently supported public choices. agent_id resolves the supported catalogue for that agent. Without agent_id, it returns the catalogue of the voice model that createAgent gives a new agent, so a voice_id can be chosen for initial_draft.voice before the first agent exists. An empty page means no voice model is ready for that agent or for new agents; service-unavailable is not an empty catalogue.

Authentication

AuthorizationBearer

Create and manage workspace-owned keys through the existing app session routes, outside this public API. Creator and manager identities are audit actors only. Key validity follows workspace policy, expiry and explicit revocation, independently of creator membership. Do not include a workspace-selection header.

Query parameters

limitintegerOptional1-200Defaults to 50

Page size; 50 by default, at most 200.

cursorstringOptional
Opaque cursor bound to the workspace, every filter, grouping and limit. Send them unchanged with it. Expires after 24 hours.
agent_idstringOptional1-128 characters
Agent whose supported voice catalogue is requested. Omit it to read the catalogue of the voice model a new agent starts on, before any agent exists.

Response headers

X-Request-IdstringOptional
Safe server request correlation ID.
RateLimit-LimitintegerOptional
Requests allowed in the current window for the tightest applicable limit.
RateLimit-RemainingintegerOptional
Requests left in the current window.
RateLimit-ResetintegerOptional
Seconds until the current window resets.

Response

List supported voices.
itemslist of objects
next_cursorstring or null
Opaque continuation cursor. Null means the last page.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error