---
title: "Update the calendar for a single listing"
method: PUT
path: "/availability-pricing/api/calendar/listings/{id}"
tags: ["Calendar"]
---

# Update the calendar for a single listing

`PUT /availability-pricing/api/calendar/listings/{id}`

Set the nightly rate, minimum stay and availability of any calendar date per listing.

## Path parameters

- `id` string, required

## Request body

- object
  - `startDate` string, date, required — First day affected by changes (format: YYYY-MM-DD)
  - `endDate` string, date, required — Last date affected by changes (format: YYYY-MM-DD)
  - `status` 'available' | 'unavailable' — New status, enum: available, unavailable.
  - `price` number — New price, in the listing's currency.
  - `isBasePrice` boolean — Whether to reset prices for the range to the listing's base price
  - `minNights` integer — New min nights value
  - `isBaseMinNights` boolean — Whether to reset min nights for the range to the listing's base min nights
  - `note` string — Note to add to those dates.
  - `cta` boolean — Set Closed To Arrival for the date range.
  - `ctd` boolean — Set Closed To Departure for the date range.
  - `useChildValues` boolean — Accept changes to minNights on sub-unit
  - `blockReason` 'Owner block' | 'Offboarded' | 'Migrated unit block' | 'Maintenance' | 'Onboarding' | 'Emergency out of order' | 'Do not sell' | 'Deactivated' | 'Other' — Reason for blocking, enum: Owner block, Offboarded, Migrated unit block, Maintenance, Onboarding, Emergency out of order, Do not sell, Deactivated, Other.

## Response `200`

Returns ok if the update successful

- string

## Other responses

- `404` — Listing Not Found
- `422` — Validation Error
- `500` — Unhandled exception. Something went wrong on server.

---

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