---
title: "Revise2 Text"
method: POST
path: "/revise2_text"
---

# Revise2 Text

`POST /revise2_text`

## Request

- Base URL: `https://api.yomu.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.yomu.ai/revise2_text`
- Auth: API key in header `ACCESS_TOKEN`

Window-cached revise: the request carries a window of consecutive document
nodes plus the id of the one node to revise. Everything shared by the window
(persona, rule, the nodes themselves) lives in the system prompt so that the
~16 sequential requests against the same window hit the provider prompt cache;
only the tiny user message changes per request.

## Request body

- Revise2Request
  - `nodes` ReviseNode[], required
    - `id` string, required
    - `text` string, required
  - `target_node_id` string, required
  - `plan` string, nullable
  - `words_used` integer, nullable
  - `prefer_gpt` string, nullable
  - `rule_name` string, nullable
  - `prompt` string, nullable
  - `strength` 'light' | 'medium' | 'strong', nullable
  - `positive_examples` string[], nullable
  - `negative_examples` string[], nullable
  - `description` string, nullable
  - `language` string, nullable
  - `stream` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/yomu/apis/yomu-api.md) - [All operations](https://skmtc.dev/yomu/apis/yomu-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yomu/apis/yomu-api/revisions/eff015f3726e?raw)