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.

Requestbash
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

  • idstringrequired

    Booking UUID or booking code.

    Example:
    0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c

Request bodyapplication/json, required

  • ratingintegerrequired

    Star rating, 1–5.

    Limits:
    minimum 1, maximum 5
    Example:
    5
  • reviewTextstring

    Public review text. May be blank.

    Example:
    Great tour, amazing guide!
  • reviewerNamestring

    Display name of the reviewer.

    Example:
    Ada Lovelace
  • reviewDatestring

    Review date (YYYY-MM-DD). Defaults to the creation time.

    Example:
    2026-07-01
  • internalFeedbackstringnullable

    Private feedback for the organizer — never displayed publicly.

    Example:
    Guide was excellent
Example: ratingOnly
ratingOnlyjson
{
  "rating": 4
}

Responses

200object

The updated review.

  • idstring (uuid)

    Review UUID.

    Example:
    8b9c0d1e-2f3a-4b4c-9d0e-1f2a3b4c5d6e
  • ratinginteger

    Star rating, 1–5.

    Example:
    5
  • reviewTextstringnullable

    Public review text.

    Example:
    Great tour, amazing guide!
  • reviewerNamestringnullable

    Display name of the reviewer.

    Example:
    Ada Lovelace
  • reviewDatestringnullable

    Review date (YYYY-MM-DD).

    Example:
    2026-07-01
  • internalFeedbackstringnullable

    Private feedback for the organizer.

    Example:
    Guide was excellent
  • statusstring

    Moderation status: PENDING, ACCEPTED or REJECTED. New reviews start PENDING.

    Allowed values:
    PENDINGACCEPTEDREJECTED
    Example:
    PENDING
Response 200json
{
  "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[].field and errors[].code.

401

Missing or invalid X-API-Key header.

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
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}