> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# reviews:write

> Generate and publish replies to social reviews

<code>reviews:write</code>

The `reviews:write` scope allows generating AI reply drafts for reviews and
publishing replies back to the upstream platform (Google Business Profile or
Facebook) via Zernio.

## Endpoints

| Method | Path                                             | Description                                     |
| ------ | ------------------------------------------------ | ----------------------------------------------- |
| `POST` | `/public/social/reviews/{id}/responses/generate` | Generate an AI reply draft                      |
| `POST` | `/public/social/reviews/{id}/responses`          | Publish a reply (new text or an existing draft) |

## Error response — Missing scope

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": {
    "code": "forbidden",
    "message": "This API key requires one of the following scopes: reviews:write",
    "details": {
      "required_scopes": ["reviews:write"]
    }
  }
}
```