Jobs

Start or resume scene-by-scene screenplay drafting.

With { scenes, throughAct? }, queues an ordered, act-ordered scene plan against an EMPTY editable draft once project setup is approved (until then — and for a script in no project — 409 project_precondition_failed names the stage to finish; a script in a product project is refused with 409 project_not_story); use throughAct to write Act 1 first. With { action: "resume" }, continues from the next unfinished scene (also the way to write the remaining acts), preserving the writer's current draft edits. Each completed scene is saved as it lands. Requires Idempotency-Key.

post/screenplay-drafts/{scriptUploadId}

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/screenplay-drafts/{scriptUploadId}
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Customer-generated stable identifier for safe retries of idempotent POST requests.

Request body

OR

Response

Screenplay drafting status after queueing.

idstring required
statusstring required

queued, writing, interrupted (a writing lease expired), awaiting_continue (an act-first draft finished its act), paused (the screenplay changed under it), reviewing (every scene written), failed, or complete. For code: show people nextStep.

nextStepstring required

The draft's state in one plain sentence, the same words the editor shows, naming the writer's move when there is one: "Writing scene 4 of 12.", "Waiting to continue: Act 1 is written. Continue the episode to write Act 2.", "Draft saved. Coverage 8.2/10. Finalize the draft to cast it and start its Table Read."

completedScenesinteger required
totalScenesinteger required
actinteger required
totalActsinteger required
errorstring nullable
contentstring required

The saved Fountain screenplay so far.

updatedAtstring date-time required

Changes

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