Trailer

Move a trailer beat to another position.

Changed on

Moves one beat to another position in the cut; toIndex is where the beat ENDS UP. NOT metered — it costs no credits and generates nothing, so there is nothing to quote or confirm. It rewrites the order and carries each beat's rendered takes and cut with it. Returns the new beatCount, movedTo, and staleBeats — the beats whose FOLLOWING beat changed, so their seam direction is out of date; their footage stays playable. A trailer with no screenplay (POST /story-projects/{projectId}/trailers) is edited this way on its draft too, since no planner draws its beats; a screenplay trailer's draft keeps the plan its planner drew. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/storyboard/move-beat

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/storyboard/move-beat
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

fromIndexinteger required

Zero-based index of the beat to move.

toIndexinteger required

Zero-based position the beat ENDS UP at.

Response

The reordered cut + the beats now out of date.

successboolean required
beatCountinteger required

How many beats the cut has after the edit.

staleBeatsinteger[] required

Beats whose FOLLOWING beat changed, so their seam direction is out of date. Their footage stays playable.

movedTointeger

Where the moved beat ended up (move only).

insertedBeatIndexinteger

Where the new beat landed (insert only).

captureOnlyboolean

Insert only: the trailer has no screenplay, so the new beat is never rendered — make it a capture beat or a title card with beats/refine; approving or finishing it is refused with trailer_capture_only while it is blank.

masterRebuild'reassembling' | 'restitching'

Remove: the last blank beat of a rendered trailer with no screenplay was removed, so its held video is rebuilt (free): reassembling in review, restitching when finished. Insert of a text card on a rendered trailer: restitching, the master stitched again with it (free). Absent otherwise.

Changes