v1

latestOpenAPI 3.1.12026-07-222968170.1 KB
reviews

put/v2/reviews/{platform}/{merchant_id}

Path parameters

platformstring required
Example:custom

The review platform. Use your platform identifier if you are a review partner, or "custom" if you are a merchant integrating a custom reviews app

merchant_idstring required

The ID of the review in the review platform

Request body

status'approved' | 'flagged' | 'pending' | 'rejected' required

The current status of the review, which determines how and when associated rules are triggered. One of: pending (the review is pending review), flagged (the review has been flagged for review), approved (the review has been approved/published), rejected (the review has been rejected)

full_textstring required

The full text of the review

ratingnumber required

The rating given in the review

images_countnumber required

The number of images attached to the review

videos_countnumber required

The number of videos attached to the review

datestring required

The date this review was updated in the review platform, as an ISO 8601 timestamp

Example request

{
  "date": "2026-01-01T12:00:00Z"
}

Response

200

Example response

{
  "review": {
    "platform": "custom",
    "full_text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit",
    "rating": 5,
    "images_count": 3
  }
}