Delete Image

This endpoint allows you to permanently delete a specific photo associated with a property. Note that only one photo can be deleted per request.

You must provide the hotel_id, channel_hotel_id, and the photo_id to be deleted in the request body.


Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/photo/delete   
-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/json
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


hotel_id string (Required)

The unique property ID as assigned by the provider upon creation of the property.


channel_hotel_id string (Required)

The unique identifier of the hotel in the specified channel.


photo_id string (Required)

Specifies the unique photo ID of the photo you want to delete.

You can only delete the property's main photo when the property is closed. If it is open and bookable, you must first set a different photo as the main photo.


Sample Request

{
   "hotel_id": "NT7",
   "channel_hotel_id":"12837615",
   "photo_id": "1xQza5mlTVs"
}

Response

Sample Success Response

{
  "Status": "Success",
  "Data": [],
  "Message": "Image Deleted Successfully",
  "Ruid": "xxxxxxxxx"
}

Success Response Body Elements

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.


Data object

The response data, the root element.


Message string

A message providing more information about the error.


Ruid string

Specifies the unique request ID.

You can share this ID with Booking.com customer support when you run into an issue. This can help in understanding what went wrong.

Errors

Sample Error Response 1

{
   "Errors": [
       {
           "Code": "400",
           "ShortText": "HotelCode: Invalid HotelCode ('NT711')"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 2

{
   "Errors": [
       {
           "Code": "573",
           "ShortText": "channel-mapping not found for this property!"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 3

{
   "Errors": [
       {
           "Code": "578",
           "ShortText": "Photos data not found"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 4

{
   "Status": "Fail",
   "Errors": [],
   "Message": "'KAVVUsPDrSg1' is not an accepted value for key photo_id"
}

Error Response Body Elements

Status string

Indicates the result of the API call, which will be always "Fail" in case of an error response.


Error array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

ShortText string

A short description of the error.


Message string

A message providing more information about the error.

Last updated

Was this helpful?