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.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/pitch-decks/{jobId}/reassemble
- Auth: HTTP bearer
Headers
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).
Changes
No recorded changes to this operation across all 2 revisions of this API.