Delete Photo

This endpoint deletes one or more photos from a specific Airbnb listing using their Airbnb photo IDs.

Endpoint

POST


Header
Type
Required
Description

app-id

string

Yes

Your application ID. Required for authentication.

Authorization

string

Yes

Your API key. for authorization. Required for authentication.

Content-Type

string

Yes

Must be set to application/json.


Attributes


hotelid alphanumeric (Required)

Specifies the required node hotelid containing the IT provider's hotel ID for which the provider wishes to add mapping information.


channelhotelid alphanumeric (Required)

Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).


listingid numeric (Required)

Listing ID of the property allocated by Airbnb.


images array of objects (Required)

Array containing image details to be uploaded.


airbnb_photo_id numeric (Required)

ID of the photo on Airbnb.



Request


Response


Success Response


Success Response - Body Elements

Status string

Indicates the result of the API call. Will be "Success" if the photos are deleted successfully.


Data array of objects

Contains information about the deleted photos. Each object contains:


listing_photo object

Contains details of the deleted listing photo:


id string

Airbnb photo ID.


listing_id string

Listing ID the photo belongs to.


caption string

Photo caption.


sort_order numeric

Order of the photo in listing.


category string

Category of the photo (e.g., "LISTING_AMENITY").


amenity string

Amenity associated with the photo.


thumbnail_url / small_url / extra_medium_url string

Photo URLs of different sizes.


Message string

Response message indicating the status of the operation.


Error Response


Error Response - Body Elements

Status string

Indicates the result of the API call.

circle-info

Will be always "Fail" in case of an error response.


Errors object

The response error, the root element.


Code string

Specific error code that helps identify the type of error.

circle-info

For example: "400" indicates a bad request.


ShortText string

A short description of the error.


Message string

The message in the response.

Last updated

Was this helpful?