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

Rewrite a content brief from a natural-language instruction (for example: 'add a section on pricing objections', 'cut the competitor comparison'). 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.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/revisions/6c5d71622cb9/schema)