Update Listing Photo

Sets or clears a photo's caption, and/or makes it the cover. The cover
is the first photo, so making a photo the cover moves it first and
leaves the others in their order. Send at least one of the fields.

Photo changes are saved in Host Tools and show on direct booking sites
straight away. While the listing's content sync is on, they also go to
Airbnb, VRBO and Houfy, which each end up with exactly these photos in
this order, and to Booking.com, where the listing's room gallery and
the property's gallery do (see "Content sync" on
/api/setListing/{listingID}).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

_id of the listing

string
required

The photo's id, from photos in /api/getListing/{listingID}

Body Params
string | null

The caption. null or an empty string clears it.

string | null

The room to put the photo in: a bedroom's id in bedroomConfiguration, or the id of one of rooms, from /api/getListing/{listingID}. null takes it out of its room. While content sync is on, Airbnb puts the photo in that room too.

boolean

true makes this photo the cover. false leaves the order as it is. To change the cover, make another photo the cover.

Headers
string

Partner API key (deprecated — use OAuth 2.0 for new integrations)

string

User's authentication token (legacy). Use Authorization Bearer header for new integrations.

Responses

429

Too many requests

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json