Trailer

Put an earlier cut of a beat back.

Puts one of a beat's earlier cuts back and re-selects the takes it was assembled from, so the finish delivers exactly what was restored. NOT metered and NOT confirmed: it renders nothing, and it is reversible — the cut it displaces joins the beat's list, so the same call with the other url undoes it. url must be a cut THIS BEAT played (read them from storyboard/takes); a url the beat never held is refused with a 400 rather than trusted. A complete trailer goes back to review. Returns { success, clipUrl, selection }. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/storyboard/restore-take

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/storyboard/restore-take
  • 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 whose earlier cut to put back.

urlstring required

The earlier cut's url, exactly as storyboard/takes returned it. A url this beat never played is refused.

Response

The cut now playing, and the takes re-selected.

successboolean required
clipUrlstring required

The cut now playing for that beat.

Changes

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