Post a reply to a review on the site it came from, edit or remove a reply, and optionally have AI draft one for you.
Post a reply to a review on the site it came from, edit or remove a reply, and optionally have AI draft one for you.
Prerequisites
- A bearer token in the
Authorizationheader. Any endpoint that needs no token says so on its own page. - The id of each record the call targets. Every endpoint page lists the ids it needs.
Errors
| Status | Meaning |
|---|---|
401 | The bearer token is missing, expired or invalid |
403 | The token is valid but the record sits outside your account |
422 | The request failed validation — the response names the fields |
500 | Unexpected server error |
Individual endpoints may return more; each page lists its own.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | Post or edit a response | Save (creates or updates) a response to a review and queues it for posting to the live review site. |
POST | Draft a response with AI | Synchronously calls the AI provider to draft a reply for a review, persists an AiReviewResponse row, and counts 1 unit against the store's ai_response plan quota (hard-stop plans return 403 once exhausted; soft-stop plans bill the call as overage). |
GET | List AI drafts for a review | List every successfully-generated AI response row for a given review, newest first (status=success, ordered by id descending). |
GET | Remove a response | Soft-delete a review response on the platform (sets it back to notresponding, clears flags, records a DeletedResponse row) and best-effort removes the live reply from Google (review_site_id 44) or Facebook (review_site_id 3). |