Scripts

Remove a character from a table read.

Removes ONE character from a table read's cast roster, so it can be set up again. Clears the character's voice from the read and its finalized flag (keeping the rest of its profile) and clears its canonical portrait on the script. The read is resolved from scriptUploadId (the caller's latest read for that script; a script that is not yours or has no read is 404 script_not_found). An unknown field, or a character that is not a non-empty string, is refused with 400 validation_failed — the same validation the Writers Lab's cast roster, MCP remove_character and sleeperhit script table-read remove-character go through. Free and naturally idempotent: removing a character the read no longer has is a no-op, and still answers removed. Scope: story:write.

post/scripts/{scriptUploadId}/table-read/characters/remove

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/scripts/{scriptUploadId}/table-read/characters/remove
  • Auth: HTTP bearer

Request body

characterstring required

The character's name (or cue) as it appears in the read. A name, not an id.

Response

The character was removed from the read.

removedboolean required

Always true — removing a character the read no longer has is a no-op that still answers true.

characterstring required

The character that was removed.

Changes

No recorded changes to this operation across all 1 revision of this API.