---
title: "Revise Content Draft"
method: POST
path: "/api/v1/content/{content_id}/revise"
tags: ["Content"]
---

# Revise Content Draft

`POST /api/v1/content/{content_id}/revise`

Rewrite an existing content draft from a natural-language instruction (for example: 'tighten the intro', 'add a section on pricing', 'remove the second half'). Applies the change to the whole article and records it as a new version, so earlier passes stay recoverable via get_content_versions / restore_content_version. Iterate by calling it again — each call starts from the current text, so no version id is needed. Use this instead of create_content to change a draft; it edits in place rather than generating a new piece.

## Path parameters

- `content_id` string, required

## Request body

- object
  - `website_id` string, required
  - `instruction` string, required

## Response `200`

Success

- object
  - `content_id` string, required
  - `body` string, required
  - `version_number` integer, required
  - `version_id` string, required

## Other responses

- `400` — Bad Request — validation failed
- `401` — Unauthenticated
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `429` — Rate Limited
- `500` — Internal Error

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/versions/6c5d71622cb9/schema)