Start a conversational season run from the Series Bible episode map.
Copies the current Series Bible episodes into a durable, editable season map and attaches an audio publishing series. Before calling, inspect document.readiness.development and complete an audio-appropriate Bible; runtime only requires a saved episode map so podcast creation is not blocked by visual/camera fields in the full development profile. Requires story:write and publishing:write because the route may create the audio series and RSS destination. Creation never approves or generates an episode: an agent must discuss each imported brief with the user, PATCH it with confirmed=true, then ask for whole-map approval. Requires Idempotency-Key for HTTP replay safety. Durable identity defaults to project + season number + Series Bible version, or an explicit runKey; a replay with different immutable create inputs is rejected. A product project's run makes one video per live (shipped or beta) feature of the season by itself: creating it maps the features (each brief agreed already) and prices what it may spend alone in spendQuote (the recordings it books, the most each finish costs); approving the map with the user's go starts it, and it stops only when an episode is blocked, saying what fixes it.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/season-runs
- Auth: HTTP bearer
Headers
Customer-generated stable identifier for safe retries of idempotent POST requests.
Request body
Response
Created or replayed season run.
Changes
No recorded changes to this operation across all 2 revisions of this API.