Trailer

Publish a finished trailer: its public watch page goes live.

Publish a finished trailer: its public watch page goes live at the writer's public slug. ONLY A complete TRAILER PUBLISHES — anything else is refused and nothing is written. The watch page is screened for outbound safety first (a held account publishes nothing). A share token is minted when the trailer has none, and a master that is missing, idle, stale or failed is re-assembled. TWO PHASES: a body without confirmed: true changes NOTHING and answers a preview (TrailerSharePreview) naming the exact watch link a publish would mint; with confirmed: true it publishes and answers TrailerPublish. A finished trailer publishes to a public watch page at the writer's slug (/{writer}/trailers/{token}): the finished master, a title and a poster, nothing to edit, unlisted (never indexed). Only a complete trailer publishes; a share token is minted when the trailer has none and cleared on unpublish, which takes the link down to 404. Publishing and unpublishing are each two-phase — without confirmed: true the call changes nothing and answers a preview (the watch link a publish would mint, or the link an unpublish would darken) — and neither is metered. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/publish

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/publish
  • 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 published trailer (relay its shareUrl verbatim); without it, the preview naming the link a publish would mint.

shareTokenstring required

The trailer's share token — the t in its public watch link. shareUrl is the same link already assembled; use it, not this.

writerSlugstring required

The writer's public slug, where the shared trailer lives.

shareUrlstring required

The trailer's full public watch link, built server-side. Give it to the user verbatim — never rebuild it from the token and slug.

renderedVideoStatusstring required

The master's state after publishing: a missing, idle, stale or failed master is re-assembled.

Changes

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