Pitch Deck

Re-assemble a deck whose assembly failed, or rebuild its master in review or complete (free).

Puts a FAILED deck back together from the takes it already has. A deck whose assembly failed for good — assemble, the 480p preview, or finish_assemble, the finished master — lost nothing it paid for: every call's takes (and their finished upscales) are kept. This re-runs THAT stage: the deck goes back to rendering (then review) or finishing (then complete). NOT metered and NOT confirmed: nothing is rendered, upscaled or reserved. Refused with 409 pitch_deck_state_invalid (details.refusal.code: pitch_deck_reassemble_not_failed, pitch_deck_reassemble_not_an_assembly_failure, pitch_deck_reassemble_pass_incomplete, pitch_deck_reassemble_missing_takes) for a deck that is not failed, one that failed while its shots were being sent to render or to be finished, a finished master missing a finished take, or a preview with no footage chapter whose takes are all in hand — GET /pitch-decks/{jobId}/chapters reassembly says which before you call. The PREVIEW follows the master's own rule: a chapter whose shot has no accepted take has no footage, so it is LEFT OUT of the master (the master plays the chapters around it) rather than refusing — the answer names each one in leftOut and in message (reassembly.leftOut says so before you call); tell the writer which chapter is missing, and render it again to put it back. The finished master never leaves a chapter out. A deck in review or complete has its master REBUILT the same way, free and FRESH, with the current sound rules (the only voices in a master are the cast's): in review the preview assembly runs (stage: assemble) — every cut an older recipe made is re-cut with the current one — and the deck STAYS in review; complete, the finished master is stitched again at its class (stage: restitch): the finished cuts as they are (the master draws the words over them), the narration, a black's sound and the score laid again with the current rules, and the deck STAYS complete (a new finish re-cuts the finished cuts). The answer's status is where the deck stays (review / complete). The selected takes are never changed; the new master is watched for video coverage at our cost. A rebuild is refused with 409 pitch_deck_reassemble_assembly_in_flight while a master is already being assembled for the deck (queued or running), pitch_deck_reassemble_take_in_flight while a shot has a take being rendered or finished, and pitch_deck_reassemble_missing_takes for a finished deck whose selected take is not finished at its class (finish it again). Requires Idempotency-Key. Scope: story:write.

post/pitch-decks/{jobId}/reassemble

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/pitch-decks/{jobId}/reassemble
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Response

The stage it runs and the status the deck is in while it runs (where it stays, for a rebuild).

jobIdstring required
queuedtrue required
stage'assemble' | 'finish_assemble' | 'restitch' required

The stage it runs: the 480p preview (assemble), the failed finished master (finish_assemble), or a complete cut's finished master stitched again at its class (restitch).

status'rendering' | 'finishing' | 'review' | 'complete' required

Where the cut is while it runs: a failed cut goes rendering then review, or finishing then complete; a rebuilt master leaves the cut where it is (review or complete).

credits0 required

Always 0.

messagestring required

What runs, and each chapter the re-assembled preview leaves out of the master.

Changes

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