---
title: "Update reservation status"
method: PUT
path: "/reservations-v3/{reservationId}/status"
tags: ["Reservations Open Api [Beta]"]
---

# Update reservation status

`PUT /reservations-v3/{reservationId}/status`

Update the status of a reservation to one of the supported statuses

## Path parameters

- `reservationId` string, required

## Request body

- object
  - `status` 'confirmed' | 'reserved' | 'awaiting_payment' | 'inquiry' | 'canceled' | 'closed' | 'declined' | 'expired', required — Status of the reservation
  - `canceledBy` 'OWNER' | 'GUEST' | 'TEAM_MEMBER' | 'HOST' — The person who cancelled reservation, if not defined will be TEAM MEMBER by default
  - `cancellationReason` string — The reason for cancelling a reservation
  - `cancellationNote` string — The note for cancelling a reservation
  - `reservedUntil` -1 | 0.5 | 0.25 | 0.17 | 12 | 24 | 36 | 48 | 72 — Duration until the reserved status expires. Only applicable when status is "reserved". Defaults to indefinitely (-1) if not provided.

## Response `200`

Reservation Status Updated

- object
  - `reservationId` string, required
  - `status` string, required
  - `reservedUntil` -1 | 0.5 | 0.25 | 0.17 | 12 | 24 | 36 | 48 | 72 — Duration until the reserved status expires. Only present when status is "reserved".

## Other responses

- `422` — Validation error failed updating status.

---

[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)