Plans

Create a StoryPlan and enqueue its async generation.

Validates target + artifactRequests + sourceIds synchronously, including source ownership and status READY, persists the plan as PENDING, and enqueues the planner backed by DB sidecar story_api_plan. Requires Idempotency-Key for safe retries. Refused with 409 project_precondition_failed until the project passes its full Series Bible coverage — details.stage names the stage to finish; retrying will not help. Non-blocking warning gate: before a screenplay/table_read plan, read or generate the full project Series Bible and review the plan against it. The planner auto-loads the saved Series Bible as canonical project truth. The response includes a preliminary quote computed from the artifact requests; the worker overwrites it with a plan-aware quote once the StoryPlan envelope is generated. Table-read plans accept creativeBrief, return a generated scriptBlueprint, cannot use autoApprove, and are limited to one table_read script/installment per plan. Table-read artifact requests may set narrationPolicy (auto | include | suppress) to make narrator/no-narrator a user-level creation choice instead of implying it from mode.

post/story-projects/{projectId}/story-plans

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/story-plans
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

titlestring
sourceIdsstring[]
autoApproveboolean

Response

Created plan envelope.

Changes

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