Trailer

Unpublish a trailer: its watch link goes dark.

Take a published trailer down: its public watch link goes dark (its page answers 404) and the trailer can be deleted again (DELETE /trailers/{jobId}). Its own edits stay. No status gate — a trailer taken live can always be taken back down, and a trailer that is not published is a no-op. TWO PHASES, the same shape as the publish: a body without confirmed: true changes NOTHING and answers a preview (TrailerSharePreview) naming the exact link that would go dark; with confirmed: true it takes the trailer down and answers TrailerUnpublish. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/unpublish

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/unpublish
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

confirmedboolean

Omit (or false) to see what the act would do WITHOUT doing it. Pass true only after the writer has seen that and said so in their own words.

Response

With confirmed: true, the trailer is down; without it, the preview naming the link that would darken.

successtrue required

Changes

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