Trailer

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

Puts a FAILED trailer back together from the takes it already has. A trailer 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 trailer goes back to rendering (then review) or finishing (then complete). NOT metered and NOT confirmed: nothing is rendered, upscaled or reserved. Refused with 409 trailer_state_invalid (details.refusal.code: trailer_reassemble_not_failed, trailer_reassemble_not_an_assembly_failure, trailer_reassemble_pass_incomplete, trailer_reassemble_missing_takes) for a trailer that is not failed, one that failed while its shots were being sent to render or to be finished, or one missing an accepted take — GET /trailers/{jobId}/beats reassembly says which before you call. A trailer 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 trailer STAYS in review; complete, the finished master is stitched again at its class (stage: restitch): the finished cuts as they are (their text layers are laid over them), the narration, a black's sound and the score laid again with the current rules, and the trailer STAYS complete (a new finish re-cuts the finished cuts). The answer's status is where the trailer 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 trailer_reassemble_assembly_in_flight while a master is already being assembled for the trailer (queued or running), trailer_reassemble_take_in_flight while a shot has a take being rendered or finished, and trailer_reassemble_missing_takes when a selected take is missing (for a finished trailer: not finished at its class — finish it again). Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/reassemble

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/trailers/{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 trailer 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 1 revision of this API.