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.
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
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.
Changes
No recorded changes to this operation across all 1 revision of this API.