Update Product Review Status (v1)

Method & Path

PATCH /api/v1/workspace/:workspaceId/storefront/product-reviews/:reviewId

Actual backend path: /v1/workspace/:workspaceId/storefront/product-reviews/:reviewId

Description

Sets moderation status for a product review: visible (shown on public storefront), pending (awaiting approval), or hidden (not shown publicly).

Authentication

Required: Bearer JWT.

Permissions: store.products.manage

Personas: Workspace Owner, Staff with product management permission.

Request Body

{
  "status": "visible"
}

Field	Type	Required	Description
status	pending | visible | hidden	Yes	Target status

Response 200 OK

{
  "review": {
    "id": "…",
    "productId": "…",
    "productName": "…",
    "rating": 5,
    "comment": null,
    "authorName": null,
    "status": "visible",
    "createdAt": "2026-04-05T10:00:00.000Z",
    "updatedAt": "2026-04-05T10:05:00.000Z"
  }
}

Common Errors

• 404 Not Found: Review does not belong to workspace
• 403 Forbidden: Insufficient permissions
• 422 Unprocessable Entity: Invalid body