---
title: "Assist Writing Fix"
method: POST
path: "/assist/writing-fix"
tags: ["assist"]
---

# Assist Writing Fix

`POST /assist/writing-fix`

## Request

- Base URL: `https://api.xeorank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xeorank.com/assist/writing-fix`
- Auth: API key in header `X-Agent-Key`

Propose the SMALLEST patches that resolve the writing findings, using the
editor model (Sonnet-class, not the lite tier). Returns find/replace pairs
keyed to findings — it never rewrites the document and never applies
anything; the caller (the user's Claude) applies what the user accepts and
re-runs review_writing. Numbers are never invented: an unsupported claim is
qualified, marked [SOURCE NEEDED] or removed. Costs WRITING_FIX_COST credits
per call; a detector-only pass (no findings) costs nothing.

## Query parameters

- `email` string, nullable

## Request body

- WritingFixBody
  - `text` string, required
  - `findings` object[], nullable
  - `target_keyword` string, nullable
  - `voice_notes` string, nullable
  - `site_id` string, nullable
  - `max_findings` integer

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xeorank/apis/seo-intelligence-engine.md) · [All operations](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/revisions/449a3fd73454?raw)