Trailer

Let one take still out at the provider go (free; it gives back what was held).

Let ONE take of the beat's call go when it is still out at the provider (handed back pending between two polls) — the per-take counterpart of Stop render (POST /trailers/{jobId}/cancel-render), on the same core. Its claim comes off the shot, the take is recorded failed with a plain notice on the beat, the writer's credits held for it are given back (releasedCredits), and the automatic fixes carry on. The provider may still bill it: that is ours, never the writer's. Every other take is kept. A take that is not out at a provider answers abandoned: false and changes nothing; one being polled right now is refused (409, details.refusal.code reference_render_take_busy: try again in a minute). The engine does the same on its own when a take's polls run out, and tells the writer. Answers { jobId, surface, callId, take, abandoned, kind, taskId, releasedCredits, note }; read GET /trailers/{jobId}/beats after it. NOT metered and NOT confirmed: free. Requires Idempotency-Key. Scope: artifact:publish — the key that can start and spend on renders is the key that can let paid work in flight go.

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

Request

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

Headers

Idempotency-Keystring required

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

Request body

callIdstring required

The call whose take to let go (its callId from the chapters or beats read).

takeinteger required

The take number (from the call's takes).

Response

Whether the take was let go, what it was waiting on, and what was given back.

jobIdstring required
surface'pitch_deck' | 'trailer' required
callIdstring required
takeinteger required
abandonedboolean required

False when the take was not out at a provider: nothing changed.

kind'render' | 'repair' | 'null' nullable required

render: a new take out at the video provider; repair: a repair out at its host. Null when nothing was let go.

taskIdstring nullable required

The provider task it was waiting on, when one had been sent. Any bill for it is ours, never the writer's.

releasedCreditsinteger required

The writer's credits given back for it (0 when the take was ours, or nothing was held).

notestring required

Read it to the writer.

Changes

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