Synchronous AI response generation + history.
Synchronous AI response generation + history. Calls the upstream provider, counts against the store-s ai_response plan-feature quota, persists every attempt to ai_review_responses. Requires authentication with per-store + per-review scope gating.
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 | Generate AI response | Synchronously calls the ReviewData 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 successful AI responses for a review | List every successfully-generated AI response row for a given review, newest first (status=success, ordered by id descending). |