Sources

Start a tour draft for every shipped feature (or every moment of one story film) that has no tour yet.

A tour draft is written from the feature’s Bible entry, its pages and the app’s address, is checked by the recorder’s own rules and saved as a drafted tour for you to edit, never opens the app, is for product projects only, and is free — up to 50 a day. No featureId on the wire: the project's Series Bible decides which features those are (a planned feature is skipped; one already drafting is answered as alreadyRunning with that run). The body may be omitted or empty; connectionId optionally names the app connection whose addresses the drafts read, and no other key exists — an unknown one is 400 validation_failed naming it. Answers started (the runs that began, in Bible order), alreadyRunning, notStarted (the features the daily cap left without a run, each with the cap's own sentence) and alreadyToured. With storyId (BL-2360) the same call drafts every product moment of that written story film that has neither a recording nor a saved tour, in the film's own order, and answers TourDraftsForMissingStoryFilmMoments: started and alreadyRunning as moment ids with their runs, notStarted per moment with its reason, alreadyToured. 202 when at least one run started, 200 when none did (a repeat starts nothing new, so no Idempotency-Key). A refusal common to every feature (no app connection, 409 project_not_product, the budget) is thrown with nothing started; the day's cap never throws — it ends the loop, the remaining features answering in notStarted.

post/story-projects/{projectId}/tours/draft-missing

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/tours/draft-missing
  • Auth: HTTP bearer

Request body

connectionIdstring

The app connection to draft through, when the project has more than one.

storyIdstring

A written story film: draft a tour for every one of its product moments that still needs one, instead of the project's features.

Response

Nothing was started (every shipped feature — or every moment of the named story film — already has a tour or a drafting run, or the cap took the first one): started is empty.

OR

Changes

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