Read the enriched cast for a table read artifact.
Returns the enriched cast for the read backing this artifact: each character's assigned voice (voiceId / voiceName / gender / provider) merged with its avatar state (avatarUrl / avatarStyle / avatarStatus), plus the artifact's resolved top-level avatarStyle. avatarStatus is none (no avatar), queued / rendering (a render is in flight), ready, or failed — poll this endpoint after recast_avatar / update_cast until in-flight renders reach ready. The cast is assigned automatically when the table read becomes performable; an empty cast means it is not performable yet (poll GET /artifacts/{artifactId}). identity warns when one character reaches two canon people or two people share a body figure, lists characters with no Series Bible appearance, and lists Series Bible names no canon person answers to (unresolvedBibleNames, with candidates). It is read-only; fix it by declaring aliases on the cast canon. restorable lists each character recast on this read whose previous voice (and recording, when recordingRecoverable) POST /artifacts/{artifactId}/voice/restore can put back. Scope: artifact:read.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/artifacts/{artifactId}/cast
- Auth: HTTP bearer
Response
Enriched cast envelope.
Changes
No recorded changes to this operation across all 1 revision of this API.