---
title: "Update a reservation comment"
method: PATCH
path: "/reservations-v3/{reservationId}/comments/{commentId}"
tags: ["Reservations Open Api [Beta]"]
---

# Update a reservation comment

`PATCH /reservations-v3/{reservationId}/comments/{commentId}`

Update an internal reservation comment. Only the comment author (from the OAuth token) may edit.

## Path parameters

- `reservationId` string, required
- `commentId` string, required

## Request body

- object
  - `body` string, required — Updated comment text
  - `mentions` string[] — User IDs to mention in the comment

## Response `200`

Success

- object
  - `_id` string, required
  - `reservationId` string, required
  - `accountId` string, required
  - `author` object, required
    - `_id` string, required
    - `fullName` string, required
    - `picture` object, nullable
      - `_id` string, required
      - `thumbnail` string, required
      - `regular` string, required
    - `authorType` 'user' | 'open-api', required — Author source: Guesty user (`user`) or OAuth application (`open-api`)
  - `body` string, nullable, required
  - `mentions` string[], required
  - `edited` boolean, required
  - `deleted` boolean, required
  - `deletedAt` string, date-time
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time
  - `parentCommentId` string — Present on reply comments only
  - `reactions` object, required — Read-only reaction aggregates keyed by emoji type (map of emoji to count and reactors)
  - `replies` object[] — Replies to this top-level comment
    - `_id` string, required
    - `reservationId` string, required
    - `accountId` string, required
    - `author` object, required
      - `_id` string, required
      - `fullName` string, required
      - `picture` object, nullable
        - `_id` string, required
        - `thumbnail` string, required
        - `regular` string, required
      - `authorType` 'user' | 'open-api', required — Author source: Guesty user (`user`) or OAuth application (`open-api`)
    - `body` string, nullable, required
    - `mentions` string[], required
    - `edited` boolean, required
    - `deleted` boolean, required
    - `deletedAt` string, date-time
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time
    - `parentCommentId` string — Present on reply comments only
    - `reactions` object, required — Read-only reaction aggregates keyed by emoji type (map of emoji to count and reactors)

## Other responses

- `400` — Returned if required fields are missing or there is a validation error in the request body
- `403` — Returned if the caller is not the comment author
- `404` — Returned if the comment was not found
- `422` — Returned if mentions are invalid
- `500` — Indicates server-side error while processing the request

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)