Update the booking's review
PATCH/v2/bookings/{id}/reviews
Requires your API key in the X-API-Key header.
Partially updates the booking's existing review (the first review on the booking). Returns 404 if the booking has no review yet — create one with POST first.
curl -X PATCH "https://api.turneo.co/v2/bookings/0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c/reviews" \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"rating": 4
}'Path parameters
idstringrequiredBooking UUID or booking code.
- Example:
0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c
Request bodyapplication/json, required
ratingintegerrequiredStar rating, 1–5.
- Limits:
- minimum 1, maximum 5
- Example:
5
reviewTextstringPublic review text. May be blank.
- Example:
Great tour, amazing guide!
reviewerNamestringDisplay name of the reviewer.
- Example:
Ada Lovelace
reviewDatestringReview date (
YYYY-MM-DD). Defaults to the creation time.- Example:
2026-07-01
internalFeedbackstringnullablePrivate feedback for the organizer — never displayed publicly.
- Example:
Guide was excellent
Example: ratingOnly
{
"rating": 4
}Responses
200object
The updated review.
idstring (uuid)Review UUID.
- Example:
8b9c0d1e-2f3a-4b4c-9d0e-1f2a3b4c5d6e
ratingintegerStar rating, 1–5.
- Example:
5
reviewTextstringnullablePublic review text.
- Example:
Great tour, amazing guide!
reviewerNamestringnullableDisplay name of the reviewer.
- Example:
Ada Lovelace
reviewDatestringnullableReview date (
YYYY-MM-DD).- Example:
2026-07-01
internalFeedbackstringnullablePrivate feedback for the organizer.
- Example:
Guide was excellent
statusstringModeration status:
PENDING,ACCEPTEDorREJECTED. New reviews start PENDING.- Allowed values:
PENDINGACCEPTEDREJECTED- Example:
PENDING
{
"id": "8b9c0d1e-2f3a-4b4c-9d0e-1f2a3b4c5d6e",
"rating": 5,
"reviewText": "Great tour, amazing guide!",
"reviewerName": "Ada Lovelace",
"reviewDate": "2026-07-01",
"internalFeedback": "Guide was excellent",
"status": "PENDING"
}Errors
- 400
Validation failed. Inspect
errors[].fieldanderrors[].code.- 401
Missing or invalid
X-API-Keyheader.- 403
The API key is valid but not allowed to perform this action on this resource.
- 404
The resource does not exist or belongs to another partner (existence is not leaked across partners).
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}