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

# Reply to Review

> Requires the `stores.update` permission.

<Note>
  Replies are **public**. Whatever you send here appears under the review on
  your storefront, next to the customer's original words.
</Note>

## How it works

A review holds **one** reply, stored on the review itself rather than as a thread. That shapes the whole endpoint:

* **`PUT` overwrites.** Call it again on the same review and you replace the previous reply - this is also how you edit one. There is no separate update endpoint.
* **There is no delete.** `reply` is required and must be at least 8 characters, so you cannot blank it out to remove a reply. Replace it with better wording instead.

## Request

```json theme={null}
{
  "reply": "Sorry this landed late - your key was reissued the same day and we've since fixed the delay."
}
```

| Field   | Rules                                       |
| ------- | ------------------------------------------- |
| `reply` | Required. Between **8 and 4096** characters |

## Permission

Requires **`stores.update`**, not a review-specific scope. A key that can reply to reviews can also change other store settings, so scope keys with that in mind.

## Finding what to reply to

Use [Get Reviews](/api-reference/endpoint/reviews/get-list) with `hasReply==false` to fetch the ones still waiting, worst first:

```bash theme={null}
curl -G "https://api.komerza.com/stores/{storeId}/reviews" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "User-Agent: MyApp/1.0" \
  --data-urlencode "filters=hasReply==false,rating<3" \
  --data-urlencode "sorts=-dateRangeFrom"
```

<Tip>
  A reply is read by far more future buyers than by the reviewer. Answer the
  question the next shopper is silently asking - what went wrong, and what you
  did about it.
</Tip>


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.komerza.com/llms.txt).