Skip to content
Wink

Respond to review

PATCH
/api/managing-entity/{managingEntityIdentifier}/extranet/review/{reviewIdentifier}/response
curl --request PATCH \
  --url https://api.wink.travel/api/managing-entity/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/extranet/review/4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62/response \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Wink-Version: 2.0' \
  --data null

Lets a hotelier post a public reply to a guest review for the given managing entity, attributing the response to the authenticated user.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
managingEntityIdentifier
required
string
""

Respond to review for property with this identifier

Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18
reviewIdentifier
required
string
""

Respond to review with this identifier

Example
4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62

Header Parameters

Section titled “Header Parameters”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Request Bodyrequired

Section titled “Request Bodyrequired”

The hotelier’s public response text

Media typeapplication/json

Hotel manager’s response to a guest review, including approval decisions for public display of the review text and uploaded photo.

object
approvedImage
required

Property approves the use of guest-generated image with property profile.

boolean
Example
true
approvedText
required

Property approves the use of guest review text with property profile.

boolean
Example
true
responseFromHotel
required

Textual response from hotel to guest’s review.

string
"" >= 1 characters
Example
Thank you so much for taking the time to share such wonderful feedback about your stay at The Siam Residences. We're delighted that you and your husband had such a memorable experience. We look forward to welcoming you back soon!
Example
{
  "approvedImage": true,
  "approvedText": true,
  "responseFromHotel": "Thank you so much for taking the time to share such wonderful feedback about your stay at The Siam Residences. We're delighted that you and your husband had such a memorable experience. We look forward to welcoming you back soon!"
}

Responses

Section titled “Responses”

200

Section titled “200”

Review response saved and published

Media typeapplication/json

Lightweight projection of a guest review, containing all publicly visible review data and metadata.

object
answers

Guest’s answers to each review question with their scores.

Array<object>

A guest’s recorded answer to a single review question, including the score and question metadata.

object
category
required

Category of the question (e.g., COMFORT, SERVICE, VALUE).

string
""
Allowed values: COMFORT CONDITION SERVICE ENVIRONMENT FACILITIES LOCATION LIFESTYLE VALUE FOOD ROOM
questionIdentifier
required

Review question identifier that this answer responds to.

string format: uuid
"" >= 1 characters
sort
required

Display order of this answer within the review.

integer format: int32
""
value
required

Guest’s numeric rating for this question on a 0-10 scale.

integer format: int32
""
approvedImage

Hotel has approved the guest’s photo for public display on their profile.

boolean
approvedText

Hotel has approved this review text for public display on their profile.

boolean
averageScore

Average rating across all question answers (0-10 scale).

number format: double
""
bookingIdentifier

Booking identifier this review is associated with.

string format: uuid
""
createdDate

Datetime this record was first created

string | null format: date-time
""
hotelIdentifier

Property (hotel) identifier this review is for.

string format: uuid
""
id

Unique identifier for this record.

string format: uuid
""
imageIdentifier

Cloudinary image identifier for guest’s photo from their stay.

string
""
lastUpdate

Datetime this record was last updated

string | null format: date-time
""
likes

User identifiers who ‘liked’ this review.

Array<string>
messageFromGuest

Private feedback message from guest to hotel manager. Not publicly displayed.

string
""
responded

Hotel has submitted a response to this review.

boolean
responseFromHotel

Hotel’s public response to the guest review.

string
""
reviewDate

Date and time the review was submitted.

string format: date-time
""
roomNumber

Guest’s room number during their stay.

string
""
roomRating

Guest’s personal rating of their room on a 0-10 scale.

integer format: int32
""
text

Guest’s written review text.

string
""
user

Guest who submitted the review.

object
email

Guest’s email address.

string format: email
""
firstName

Guest’s first name.

string
""
fullName

Guest’s full name.

string
""
lastName

Guest’s last name.

string
""
telephone

Guest’s phone number.

string
"" /^\+?[1-9]\d{1,14}$/
userIdentifier

User identifier

string format: uuid
""
version

Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.

integer | null format: int64
""
key
additional properties
""
Example
{
  "answers": [
    {
      "category": "SERVICE",
      "questionIdentifier": "4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62",
      "sort": 1,
      "value": 7
    }
  ],
  "approvedImage": false,
  "approvedText": true,
  "averageScore": 8.7,
  "bookingIdentifier": "f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92",
  "createdDate": "2026-01-14T09:30:00",
  "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18",
  "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
  "imageIdentifier": "wink/review/siam-residences-2026-01-14-xyz123abc",
  "lastUpdate": "2026-02-03T16:45:12",
  "messageFromGuest": "Dear GM, I would like to say thank you so much for taking the time to show my husband and me around the premises and the secret cave behind the property.",
  "responded": false,
  "responseFromHotel": "Thank you so much for taking the time to share such wonderful feedback about your stay at The Siam Residences. We're delighted that you and your husband had such a memorable experience. We look forward to welcoming you back soon!",
  "reviewDate": "2026-01-14T09:30:00",
  "roomNumber": "501",
  "roomRating": 9,
  "text": "Our stay was amazing! The staff made us feel truly welcomed, and the traditional Thai breakfast was exceptional. Can recommend highly to all. Felt like home.",
  "user": {
    "email": "[email protected]",
    "firstName": "Alexandra",
    "fullName": "Alexandra Beaumont",
    "lastName": "Beaumont",
    "telephone": "+66 2 126 8866",
    "userIdentifier": "c3a9f2e1-8b4d-4c7a-a1e2-5f0b6d9e2c84"
  },
  "version": 3
}

400

Section titled “400”

Bad Request — missing or invalid request parameter or body

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

401

Section titled “401”

Unauthorized — authentication is required or the session has expired

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

403

Section titled “403”

Forbidden — authenticated but lacking the required permission or scope

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

404

Section titled “404”

Not Found — the requested resource does not exist

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

405

Section titled “405”

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

409

Section titled “409”

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

415

Section titled “415”

Unsupported Media Type — use application/json

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

500

Section titled “500”

Internal Server Error — an unexpected failure occurred on the server

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example

503

Section titled “503”

Service Unavailable — a downstream dependency is unreachable

Media typeapplication/problem+json
object
detail
string
instance
string format: uri
properties
object
key
additional properties
status
integer format: int32
title
string
type
string format: uri
key
additional properties
""
Example