Trailer

Remove a trailer beat.

Removes one beat from the cut, with everything already rendered on it. NOT metered — and it refunds nothing: what that beat bought is gone. The cut's last beat cannot be removed. Returns the new beatCount and staleBeats. 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/remove-beat

Request

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

Headers

Idempotency-Keystring required

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

Request body

beatIndexinteger required

Zero-based index of the beat to remove.

Response

The shortened 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 blank 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 only: 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. Absent otherwise.

Changes

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