---
title: "Revise Chapter From Notes"
method: POST
path: "/api/mcp/revise_chapter_from_notes"
tags: ["mcp"]
---

# Revise Chapter From Notes

`POST /api/mcp/revise_chapter_from_notes`

## 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/revise_chapter_from_notes`
- Auth: none declared

Gather open chapter review notes and start a normal chapter revision.

This is a convenience bridge for Codex and the website: notes are
stored on the chapter, gathered here, then fed through the existing
revise_chapter pipeline. Notes resolve only after the worker commits
a new chapter revision.

## Request body

- ReviseChapterFromNotesInput
  - `job_id` string, required: The story job ID.
  - `chapter` integer, required: Chapter number to revise from open review notes.
  - `note_ids` string[], nullable: Optional specific open note ids to apply. Omit to apply all open notes on the chapter.
  - `instruction` string: Caller instruction wrapped around the gathered open notes.
  - `base_revision` integer, nullable: Which revision number to revise from. None = latest.
  - `target_words` integer, nullable: Target word count for the revised chapter.
  - `model` string, nullable: Model override for the server revision path.
  - `revision_mode` 'surgical' | 'scene_rewrite' | 'full_rewrite', nullable: Caller-declared revision scope. Defaults to scene_rewrite.
  - `bypass_plan_reason` string, nullable: Optional explicit reason to bypass structured planning for large/full rewrites.

## Response `200`

Successful Response

- GenericToolResponse: Fallback for tools whose payload is still being tightened.
  - `story_url` string, nullable
  - `article_url` string, nullable
  - `job_id` string, nullable
  - `status` string, nullable
  - `is_terminal` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/swapp1990/apis/writeforyou-mcp-api.md) · [All operations](https://skmtc.dev/swapp1990/apis/writeforyou-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/swapp1990/apis/writeforyou-mcp-api/revisions/ce5e2a89ab4d?raw)