---
title: "Revise Text"
method: POST
path: "/revise_text"
---

# Revise Text

`POST /revise_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/revise_text`
- Auth: API key in header `ACCESS_TOKEN`

## Request body

- ReviseRequest
  - `text` string, required
  - `context` string, nullable
  - `future_context` string, nullable
  - `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
  - `history` string[], nullable
  - `language` string, nullable
  - `stream` boolean, nullable
  - `humanize` 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)