Projects

Save episode character direction without generating or spending credits.

Existing images and voices remain unchanged. avatarPrompt guides headshots and sheets; figurePrompt guides body shots. signatureItems (what only this person wears or carries) is saved on the project cast canon for every episode. A person on the project cast canon whom the episode does not name (a deck or trailer draws them from the canon) takes signatureItems alone, saved on their canon entry (projectCast: true in the answer); any other field sent for them is refused by name. When the canon cannot tell who the character is, nothing is saved and a 409 names the candidates; the writer answers with sameAs (the character IS that canon person, so the script name becomes their alias) or newPersonName (someone else, saved under that full name). A separate quote and confirmation are required to replace assets.

patch/story-projects/{projectId}/cast

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/cast
  • Auth: HTTP bearer

Request body

scriptUploadIdstring required
characterstring required
avatarPromptstring
figurePromptstring
agestring
genderstring
personalitystring
speechStylestring
backstorystring
relationshipsstring
signatureItemsstring[]

What only this person wears or carries ("round wire spectacles"). Saved on the project cast canon for every episode, not on this episode; replaces the saved list, and an empty list clears it.

sameAsstring

The writer says this character IS this cast canon person (a candidate id or name: "IVAN is Ivan Karamazov"). The script name becomes their alias, and a stray canon row named by the script name is folded into them, their art standing. Send only on the writer's answer. Not with newPersonName.

newPersonNamestring

The writer says this character is someone else: saved in the cast canon under this full name, with the script name as an alias. Not with sameAs.

Response

Saved direction; generated is always false.

savedunknown required
characterstring required
generatedunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.