Start a tour draft for one feature of the project, or for one product moment of a story film.
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. A story film’s product moment that still needs a recording can be drafted as its own tour: it types the story’s own names into the app and hesitates where the scene says to, and when its recording is finished it becomes that moment’s recording. featureId names the feature (a Series Bible episode); or source: { kind: 'story_beat', storyId, captureRequestId } names a story film's product moment that still needs a recording (it names its own feature; one drafting run per moment). connectionId optionally names the app connection whose address the draft reads. 202 with the new run; 200 with alreadyRunning: true and the run already drafting (no second run starts, so no Idempotency-Key). Poll GET until the run is ready or failed. 409 project_not_product for a story project; 409 script_state_invalid for a film with no script or a moment that already uses a recording; 400 for a moment whose side effects a recording may not perform; 403 usage_limit_reached past the daily limit.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/tours/drafts
- Auth: HTTP bearer
Request body
Response
A run was already drafting: this is it (alreadyRunning: true).
Changes
No recorded changes to this operation across all 1 revision of this API.