Trailer

Select a take of one of a beat's calls.

Chooses which take of one call the cut plays and the finish delivers. NOT metered and NOT confirmed: it renders nothing and is reversible (select another take), and the beat's preview cut is re-assembled from the new selection. Any accepted take may be selected, a flagged one included; the answer's warning names what it is flagged for, and the finish quote and export carry it too. A take that produced no file cannot be selected. In a complete trailer a new selection sends the cut back to review, and the next finish quotes just that take. Review or complete only. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/beats/{beatIndex}/select-take

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/beats/{beatIndex}/select-take
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

callIdstring required

One of this beat's call ids (from the beats read). A call of another beat is refused.

takeinteger required

A take number from the call's takes. A take that produced no file cannot be selected.

Response

The take now selected.

jobIdstring required
beatIndexinteger required
callIdstring required
takeinteger required
warningstring nullable required

Set when the chosen take is flagged: the finish quote and the export carry this sentence.

Changes

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