Skip to navigation

Get Voice

Fetch a single voice by its ID.

Returns both platform (system-wide) voices and voices that belong to the caller’s workspace. Returns 404 when the voice does not exist, is not accessible to the caller’s workspace, or is a platform voice from a provider that is not available to your account. Voices your workspace owns stay readable regardless of provider availability. The sample_url field is a time-limited presigned URL valid for 1 hour; regenerate it by calling this endpoint again rather than caching it long-term. This endpoint sets Cache-Control: no-store because the response bakes in that short-lived presigned URL — server-side (Redis) caching still applies underneath.

Authentication

AuthorizationBearer
Clerk JWT token
OR
AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

voice_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response
dataobject
metaobject

Errors

422
Unprocessable Entity Error