Trailer

Edit a draft trailer's intent.

Edits the intent of a DRAFT trailer: each field given replaces the stored one (arc the whole four-stage arc), and the merged intent must be complete and build (the arc's intensity rises to the turn). Editing the intent is free and only while the plan is a draft (approving the plan approves its intent): it saves the new intent and queues plan coverage again for the latest revision — a burst of edits is one coverage run, started once the plan has been left alone for three minutes. The chapters or beats are not re-planned; edit them (their arcStage, advancesQuestion and whyItFollows included) to follow the new intent. A plan planned before intents existed takes a complete intent. Answers the saved intent, the changed plan's planCoverage and arcProblems — where the beats now break the new arc (fix them with the beat refine's arcStage and advancesQuestion). Refused once the plan is approved (409). Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/intent

Request

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

Headers

Idempotency-Keystring required

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

Request body

purposestring
audiencestring
loglinestring
themestring
centralQuestionstring
stakesstring
viewerPromisestring
endingstring

Response

The saved intent.

successboolean required
planKind'pitch_deck' | 'trailer' required
jobIdstring required
planCoverage'queued' | 'current' | 'failed' | 'null' nullable required

The changed plan's coverage: queued for the latest edit (one run per burst of edits, started once the plan has been left alone for three minutes), current (already scored or being scored), failed (could not be queued). Null when the edit changed nothing.

Changes

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