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

# Revise Content Brief

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

## Request

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

Rewrite a content brief from a natural-language instruction (for example: 'add a section on pricing objections', 'cut the competitor comparison'). An AI model performs the rewrite server-side, so the result is generated text, not your literal wording. Records each pass as a version; iterate by calling it again, since each call starts from the current brief. Most useful while a piece waits at status generated_brief, where the brief still shapes what the article will say — call approve_brief once it reads right. It also works after the article exists, to correct the brief for a later regeneration; note that revising the brief does NOT rewrite an already-generated article, so use revise_content for that.

## Path parameters

- `content_id` string, required

## Request body

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

## Response `200`

Success

- object
  - `content_id` string, required
  - `brief` 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.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)