Seasons

Save one agreed episode brief while mapping a season.

Partial update available only while the run is mapping. Set confirmed=true only after the user has discussed and agreed to the title, summary, objective, audience/tone, duration, and notes. expectedMapVersion is required on every PATCH so two agent conversations cannot silently overwrite each other. Map edits are locked permanently after approval.

patch/season-runs/{runId}/episodes/{episodeId}

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/season-runs/{runId}/episodes/{episodeId}
  • Auth: HTTP bearer

Request body

expectedMapVersioninteger required

Required optimistic-concurrency version from the latest SeasonRun response. A mismatch returns season_run_state_invalid; reload before retrying.

userConfirmedboolean

Required and true when patch.confirmed=true, after the user explicitly agrees to this episode brief.

Response

Updated season run.

Changes

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