Seasons

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.

post/story-projects/{projectId}/season-runs

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

Idempotency-Keystring required

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

Request body

publishingSeriesIdstring

Existing audio publishing series in this project. Omit to reuse the first audio series or create one automatically.

titlestring
seasonNumberinteger
runKeystring

Optional durable domain identity. Reusing a runKey with different title, season, Bible version, policy, audience intent, audience policy, or explicit series is rejected.

audienceIntent'INTERNAL' | 'EXTERNAL'

Who this season's finished work is for. INTERNAL stays inside the company; EXTERNAL leaves it. Fixed when the season is created and never editable afterwards — escalating a season after material is already in it would retroactively re-license work nobody reviewed for the outside. To take a season public, create a new EXTERNAL season and re-curate its sources.

Response

Created or replayed season run.

Changes

No recorded changes to this operation across all 2 revisions of this API.