Delete Product Review
Delete an existing product review. Only the review author can delete their own review.
Endpoint
DELETE /api/shop/reviews/{reviewId}Request Headers
| Header | Required | Description |
|---|---|---|
Content-Type | Yes | application/json |
X-STOREFRONT-KEY | Yes | Your storefront API key |
Authorization | Yes | Bearer token (review author required) |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
reviewId | integer | Yes | The review to remove. No product ID is part of the path. |
Response
204 No Content with an empty body. There is no confirmation message — the status is the confirmation.
Ownership
A review may only be removed by the customer who wrote it, checked against the stored author:
- Another customer's review answers
403. - A review submitted by a guest has no author and can never be removed through the API — also
403. - Deletion is permanent; the row is not soft-deleted and cannot be restored.
Use Cases
- "Delete your review" on a product page — call with the review ID and drop the row locally; the empty body leaves nothing to re-render from.
- Replace a review — there is no resubmit flow, so removing and creating again is how a shopper starts over. The new review returns to
pending.
Best Practices
- Confirm before calling — the removal is immediate and irreversible.
- Prefer Update for corrections — editing keeps an approved review live, while deleting and recreating sends it back into moderation.
- Do not parse a body — a
204carries none.
Related Resources
- Get Product Review — one review by id, whatever its status
- Create Product Review — submit a review; it starts as pending
- Update Product Review — edit the customer's own review