mcp

Update Outline

Low-level direct replacement of the plan. Caller sends the full plan dict; this endpoint does not merge or diff — it replaces.

Prefer refine_outline(apply=true) for conversational edits: it builds the new plan from the running chat and commits atomically. Reach for update_outline only when you already have a fully-formed plan dict (e.g. programmatic transforms, reapplying a saved plan).

Valid after planning has produced a plan, including post-write and cancelled stories. Written chapter rows remain frozen unless an outline-review client explicitly sets allow_written_outline_edits.

post/api/mcp/update_outline

Request

  • Base URL: https://writer.swapp1990.org (the document declares no server; this is the origin it was published from)
  • URL: https://writer.swapp1990.org/api/mcp/update_outline
  • Auth: none declared

Request body

job_idstring required

The story job ID.

planobject required

Full replacement plan. Same shape as output_artifacts.plan.

allow_written_outline_editsboolean

Allow outline rows for already-written chapters to change while leaving chapter prose untouched. Defaults to false to preserve the legacy prose/outline consistency guard.

target_words_per_chapterinteger nullable

Optional length override. Updates the writer's per-chapter target. Omit to leave unchanged — there is no other way to edit target length mid-review.

Response

Successful Response

story_urlstring nullable
article_urlstring nullable
job_idstring nullable
statusstring nullable
is_terminalboolean nullable

Changes

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