---
title: "Revise the draft (charges credits)"
method: POST
path: "/content-pieces/{id}/revise"
tags: ["Content"]
---

# Revise the draft (charges credits)

`POST /content-pieces/{id}/revise`

## Request

- Base URL: `https://api.serppro.ai/rest`
- URL: `https://api.serppro.ai/rest/content-pieces/{id}/revise`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `goal` 'readability' | 'intent' | 'fluff' | 'custom'
  - `instruction` string
  - `search_intent` string
  - `markdown` string

## Response `200`

OK

---

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