---
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`

## Request

- Base URL: `https://api.athenahq.ai`
- URL: `https://api.athenahq.ai/api/v1/content/{content_id}/revise`
- Auth: API key in header `x-api-key`

Rewrite an existing content draft from a natural-language instruction (for example: 'tighten the intro', 'add a section on pricing', 'remove the second half'). An AI model performs the rewrite server-side, so the result is generated text, not your literal wording; when you already have the exact replacement text, use the edit endpoint instead. 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. The returned body is always the complete replacement article, never just the edited passage; compare body_word_count with previous_body_word_count to confirm nothing unexpected was lost.

## 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
  - `body_word_count` integer, required
  - `previous_body_word_count` integer, required

## Other responses

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

## Changes

- **2026-11-03** `2d1d86d5e067`: 2 info
  - added the required property `body_word_count` to the response with the `200` status
  - added the required property `previous_body_word_count` to the response with the `200` status

[Operation history](https://skmtc.dev/athenahq/apis/athenahq-api/changes/api/v1/content/:content_id/revise/post.md)

---

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