---
title: "Apply Revision Suggestion Route"
method: POST
path: "/api/v1/content/revision-suggestions/{suggestion_id}/apply"
tags: ["Content Management"]
---

# Apply Revision Suggestion Route

`POST /api/v1/content/revision-suggestions/{suggestion_id}/apply`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/api/v1/content/revision-suggestions/{suggestion_id}/apply`
- Auth: none declared
- TypeScript: <https://skmtc.dev/getanana/apis/cleon-api/docs/api/v1/content/revision-suggestions/:suggestion_id/apply/post.ts> (a function with typed inputs; its response is checked against the schema)

Apply one suggestion now: a live page publishes it in its current visibility,
a draft stays a draft. No separate publish step.

## Path parameters

- `suggestion_id` string, uuid, required

## Request body

- KcRevisionApplyRequest: ``replacement`` is the person's edit; None applies the proposed text (or, on a retry after a failure, the text that was already approved).
  - `replacement` string, nullable

## Response `200`

Successful Response

- KcRevisionSuggestionRead
  - `id` string, uuid, required
  - `review_id` string, uuid, required
  - `sequence` integer, required
  - `original_text` string, required
  - `proposed_text` string, required
  - `rationale` string, required
  - `evidence` object, nullable
  - `experiment_id` string, uuid, nullable
  - `status` 'proposed' | 'applied' | 'rejected' | 'conflict' | 'failed', required: Where one agent-proposed KC revision suggestion stands. PROPOSED → APPLIED / REJECTED / CONFLICT / FAILED. There is no in-flight state: an apply is one transaction, so it either commits APPLIED or rolls back. FAILED may be retried (or rejected); CONFLICT is final — the page changed under it.
  - `approved_text` string, nullable
  - `applied_at` string, date-time, nullable
  - `decided_at` string, date-time, nullable
  - `error` string, nullable

## Other responses

- `404`: Suggestion not found
- `409`: The suggestion cannot be applied or decided now
- `422`: The edited text cannot be applied safely, or the request is invalid

## Changes

> 83 revisions in range; 1 not diffed.

- **2026-10-29** `505b77adb8e7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/content/revision-suggestions/:suggestion_id/apply/post.md)

---

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