---
title: "Update a listing"
method: PUT
path: "/listings/{id}"
tags: ["Listings"]
---

# Update a listing

`PUT /listings/{id}`

## Path parameters

- `id` string, required

## Request body

- object
  - `accommodates` number
  - `bathrooms` number — Starting March 4th 2025, the bathroom field will be deprecated. Please use the Spaces endpoints to add and manage bathroom details moving forward.
  - `minimumAge` number
  - `defaultCheckInTime` string
  - `defaultCheckOutTime` string
  - `timezone` string
  - `propertyType` 'Aparthotel' | 'Apartment' | 'Barn' | 'Bed & Breakfast' | 'Boat' | 'Boutique hotel' | 'Bungalow' | 'Cabin' | 'Camper/RV' | 'Casa particular (Cuba)' | 'Castle' | 'Cave' | 'Chalet' | 'Condominium' | 'Cottage' | 'Cycladic house (Greece)' | 'Dammuso' | 'Dome house' | 'Dorm' | 'Earth house' | 'Farm stay' | 'Guest suite' | 'Guesthouse' | 'Heritage hotel (India)' | 'Holiday home' | 'Hostel' | 'Hotel' | 'House' | 'Houseboat' | 'Hut' | 'Igloo' | 'In-law' | 'Inn' | 'Island' | 'Lighthouse' | 'Loft' | 'Minsu' | 'Nature lodge' | 'Other' | 'Parking Space' | 'Pension (South Korea)' | 'Plane' | 'Resort' | 'Rv' | 'Ryokan (Japan)' | 'Serviced apartment' | 'Shepherds hut' | 'Studio' | 'Tent' | 'Timeshare' | 'Tiny house' | 'Tipi' | 'Townhouse' | 'Train' | 'Treehouse' | 'Trullo (Italy)' | 'Vacation home' | 'Villa' | 'Windmill' | 'Yurt' — Describes the kind of property where your guest will stay (e.g., Apartment, House, Villa, Boat, Tent, etc.). Corresponds to the Property type in the UI
  - `roomType` 'Entire home/apt' | 'Private room' | 'Shared room' — Indicates the level of privacy your guest will have during their stay (e.g., Entire home/apt, Private room, or Shared room). Corresponds to the Listing type in the UI
  - `otaRoomType` 'Apartment' | 'Bed in dormitory' | 'Bungalow' | 'Chalet' | 'Dormitory room' | 'Double' | 'Family' | 'Holiday home' | 'Mobile home' | 'Quadruple' | 'Single' | 'Studio' | 'Suite' | 'Tent' | 'Triple' | 'Twin' | 'Villa' — A Booking.com-specific field that defines either the property type or room capacity, depending on whether the stay is in a full unit or a single-room setup (e.g., Suite, Double, Villa, Bed in dormitory). Corresponds to the Room type in the UI
  - `childrenToConnect` string[] — Array with children ids that are supposed to be connected
  - `childrenToDisconnect` string[] — Array with children ids that are supposed to be disconnected
  - `numberOfChildrenToCreate` number — Number of children to create automatically
  - `address` object
    - `full` string — full address
    - `lng` number
    - `lat` number
    - `street` string
    - `city` string
    - `country` string
  - `pms` object
    - `active` boolean
    - `automation` object
      - `autoList` object
        - `active` boolean
        - `config` string[]
    - `inbox` object
      - `customSignature` string
    - `cleaningStatus` object
      - `value` 'clean' | 'waitingForInspection' | 'dirty' | 'unknown'
      - `updatedAt` string
    - `paymentProcessing` object
      - `active` boolean
      - `paymentProviders` object
        - `stripe` object
          - `active` boolean
          - `status` string
          - `accountName` string
          - `defaultCurrency` string
          - `syncedAt` string, date
          - `payload` object
            - `id` string
            - `livemode` boolean
            - `token_type` string
            - `stripe_publishable_key` string
            - `stripe_user_id` string
            - `scope` string
    - `autoPayments` object
      - `policy` unknown[]
        - unknown
  - `tags` string[]
  - `nickname` string
  - `publicDescription` object
    - `summary` string
    - `space` string
    - `access` string
    - `interactionWithGuests` string
    - `neighborhood` string
    - `transit` string
    - `notes` string
    - `houseRules` string
  - `hostName` string
  - `houseManual` string
  - `parkingInstructions` string
  - `trashCollectedOn` string
  - `wifiName` string
  - `wifiPassword` string
  - `cleaning` object
    - `defaultCleaningTime` string
    - `instructions` string
  - `isTest` boolean — Marks the listing as a test property. Test property titles must include the 'Test_' prefix. Only SINGLE-type listings can be selected.

## Response `200`

Retrieve the updated listing, selection of fields that were sent in body.

- object
  - `_id` string — String (ObjectId)
  - `accountId` string — String (ObjectId)
  - `createdAt` string
  - `integrations` object[]
    - `_id` string — Unique Id
    - `airbnb2` object — Only if platform is airbnb
      - `credentials` object
        - `code` string
        - `expiresAt` integer
        - `accessToken` string
        - `refreshToken` string
        - `lastForceRefresh` string — date
      - `forwardEmails` object
        - `all` boolean
        - `emails` string[]
      - `createdAt` string — date
    - `forwardEmails` object
      - `all` boolean
      - `emails` string[]
    - `active` boolean — Status of connection
    - `platform` string
    - `listings` object[]
    - `complexes` object[]
    - `nickname` string
    - `channelId` string
    - `activatedAt` string — Date
    - `disconnectedAt` string — Date
    - `proxyEmail` string
    - `incomingEmail` string
    - `externalAccountId` string
    - `id` integer — External ID
    - `companyName` string
    - `fetchRequests` object[]
      - `fetchAllListings` boolean
      - `externalListingIds` string[]
      - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'TIMEOUT'
      - `createTime` string — Date
      - `updateTime` string — Date
      - `finishedTime` string — Date
    - `status` 'NOT_CONNECTED' | 'CONNECTING' | 'CONNECTED' | 'FAILED' | 'TIMEOUT' | 'DISCONNECTED' | 'PENDING'
    - `migration` object
      - `status` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED'
      - `createTime` string — Date
      - `updateTime` string — Date
      - `finishedTime` string — Date
      - `steps` object[]
      - `discrepancyStepExecuted` boolean
      - `discrepancyResolution` 'GUESTY' | 'AIRBNB'
      - `listingQuantityDiscrepancyStepExecuted` boolean
      - `error` object
        - `at` string — Date
        - `code` string
        - `message` string
        - `raw` object
      - `notes` string
      - `isRollingBack` boolean
    - `userId` string
    - `accountId` string — Owner
    - `tripAdvisor` object — TripAdvisor details
    - `homeaway2` object — Homeaway details
    - `bookingCom` object — BookingCom details
      - `legalEntityId` string
    - `createdAt` string — Date
    - `missingStep` string
    - `steps` object[]
      - `type` string
      - `status` 'COMPLETED' | 'IN_PROGRESS'
      - `createTime` string — Date
      - `updateTime` string — Date
    - `newIntegrationBackup` object
    - `threadIdsMigrated` boolean
    - `isDeleted` boolean
    - `deletedAt` string — Date
  - `isVirtual` boolean
  - `nickname` string
  - `tags` string[]
  - `isListed` boolean
  - `title` string
  - `propertyType` string
  - `roomType` string
  - `bedType` string
  - `accommodates` number
  - `bedrooms` number
  - `areaSquareFeet` number
  - `address` object
    - `full` string — full address
    - `lng` number
    - `lat` number
    - `street` string
    - `city` string
    - `country` string
  - `publishedAddress` object
    - `full` string — full address
    - `lng` number
    - `lat` number
    - `street` string
    - `city` string
    - `country` string
  - `timezone` string
  - `defaultCheckInTime` string
  - `defaultCheckOutTime` string
  - `cleaning` object
    - `defaultCleaningTime` string
    - `instructions` string
  - `cleaningStatus` object
    - `value` 'clean' | 'waitingForInspection' | 'dirty' | 'unknown'
    - `updatedAt` string
  - `picture` object
    - `regular` string
    - `thumbnail` string
    - `large` string
    - `caption` string
    - `height` number
    - `original` string
    - `size` number
    - `width` number
  - `pictures` object[]
    - `regular` string
    - `thumbnail` string
    - `large` string
    - `caption` string
    - `height` number
    - `original` string
    - `size` number
    - `width` number
  - `amenities` string[]
  - `amenitiesNotIncluded` string[]
  - `terms` object
    - `minNights` number
    - `maxNights` number
    - `cancellation` string
  - `prices` object
    - `guestsIncludedInRegularFee` number
    - `extraPersonFee` number
    - `basePrice` number
    - `basePriceUSD` number
    - `monthlyPriceFactor` number — Accepted values are float values between 0 and 1. In order to have 10% discount set 0.90. To have 5% discount set 0.95.
    - `weeklyPriceFactor` number — Accepted values are float values between 0 and 1. In order to have 10% discount set 0.90. To have 5% discount set 0.95.
    - `weekendBasePrice` number
    - `securityDepositFee` number
    - `currency` string
    - `cleaningFee` number
  - `netIncomeFormula` string
  - `commissionFormula` string
  - `commissionTaxPrecentage` string
  - `pms` object
    - `active` boolean
    - `automation` object
      - `autoList` object
        - `active` boolean
        - `config` string[]
    - `inbox` object
      - `customSignature` string
    - `cleaningStatus` object
      - `value` 'clean' | 'waitingForInspection' | 'dirty' | 'unknown'
      - `updatedAt` string
    - `paymentProcessing` object
      - `active` boolean
      - `paymentProviders` object
        - `stripe` object
          - `active` boolean
          - `status` string
          - `accountName` string
          - `defaultCurrency` string
          - `syncedAt` string, date
          - `payload` object
            - `id` string
            - `livemode` boolean
            - `token_type` string
            - `stripe_publishable_key` string
            - `stripe_user_id` string
            - `scope` string
    - `autoPayments` object
      - `policy` unknown[]
        - unknown
  - `receptionistsService` object
    - `receptionDesk` object
      - `ittt` unknown[]
        - unknown
    - `screening` object
      - `checklist` unknown[]
        - unknown
    - `contactPersonUserId` string
  - `active` boolean
  - `customFields` object
  - `calendarRules` object
  - `publicDescription` object
  - `privateDescription` object
  - `markups` object
  - `isTest` boolean — Marks the listing as a test property. Test property titles must include the 'Test_' prefix. Only SINGLE-type listings can be selected.

---

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