Update listing details

Updates listing details such as name, description, amenities, pricing, and metadata.

Authorization

x-calry-api-key

x-calry-api-key<token>

In: header

Path Parameters

id*string

Unique identifier of the listing

Header Parameters

x-calry-tenant-id?string

Optional tenant ID to specify which tenant to operate as. If not provided, the default tenant will be used.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?string

Name of the listing

internalName?string

Internal name of the listing

description?string

Description of the listing

type?string

Type of the property

thumbnailURL?string

URL of the thumbnail image of the listing

pictures?array<>

List of pictures of the listing

address?object

Address of the listing

latitude?number

Latitude of the map marker

longitude?number

Longitude of the map marker

minimumNights?number

Minimum Nights

maximumNights?number

Maximum Nights

maxOccupancy?number

Maximum Occupancy

startPrice?number

Start price for listing as set on provider

currency?string

Currency for displaying prices

timeZone?string

Timezeone at listing

bedroomCount?number

Bedroom count for the listing

bathroomCount?number

Bathroom count for the listing

rooms?object

Room information for the listing

checkIn?object

Check-in information for the listing

checkOut?object

Check-out information for the listing

contact?

Contact information for listing

rating?object

Rating for the property

providerID?string

Provider ID for the listing

listingDetails?object

Listing Details

parentPropertyID?string

Parent property ID for this listing

amenities?object

Amenities for the listing

Response Body

`application/json`

curl -X PUT "https://example.com/api/v1/listing/123e4567-e89b-12d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{}'

Empty

{
  "timestamp": "2025-03-05T11:45:49.631Z",
  "path": "<URL_PATH>",
  "message": "Authentication failed",
  "details": []
}