Update Photo

This endpoint updates captions, sort order, and other details of existing photos for a specific Airbnb listing.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/photo/update

---

Header

-app-id: App Id
Authorization: Basic Authorization
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

---

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.

---

caption string (Optional)

Caption for the image.

---

sort_order numeric (Optional)

Order of the image.

---

airbnb_photo_id numeric (Required)

ID of an already created photo on Airbnb.

---

category enum (Required)

Short description of the photo. Allowed values: LISTING, ROOM, LISTING_AMENITY, ROOM_AMENITY.

---

facility_id numeric (Required only if category is LISTING_AMENITY or ROOM_AMENITY)

ID of the facility for which the image is uploaded.

---

Request

{
  "hotelid": "SUTEST01",
  "channelhotelid": "511039958",
  "listingid": "1541919118065328804",
  "images": [
    {
      "caption": "Pool Side Views",
      "sort_order": 1,
      "airbnb_photo_id": "1541919118065328804_2388273814",
      "room_id": "1234569"
    },
    {
      "caption": "Beautiful Lake Views",
      "sort_order": 2,
      "airbnb_photo_id": "1541919118065328804_2388273823",
      "room_id": ""
    },
    {
      "caption": "Garden View",
      "sort_order": 3,
      "airbnb_photo_id": "1541919118065328804_2388273831",
      "room_id": ""
    }
  ]
}

---

Response

---

Success Response

{
  "Status": "Success",
  "Data": {
    "1541919118065328804_2418824172": {
      "id": "1541919118065328804_2418824172",
      "message": "Updated"
    },
    "1541919118065328804_2418824048": {
      "message": "Updated",
      "id": "1541919118065328804_2418824048"
    },
    "1541919118065328804_2388273831": {
      "message": "Updated",
      "id": "1541919118065328804_2388273831"
    }
  },
  "Message": "Photos updated successfully"
}

---

Success Response - Body Elements

Status string

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

---

Data object

Contains the status of each updated photo, keyed by their Airbnb photo ID. Each object contains:

---

id string

The Airbnb photo ID.

---

message string

Status message indicating the photo was updated.

---

Message string

Response message indicating the overall result of the update operation.

---

Error Response

Error 1

{
  "Status": "Fail",
  "Errors": [],
  "Message": "Photo ID: 1541919118065328804_2388273823 - Unfortunately, this is no longer available., Photo ID: 1541919118065328804_2388273814 - Unfortunately, this is no longer available."
}

---

Error Response - Body Elements

Status string

Indicates the result of the API call.

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.

For example: "400" indicates a bad request.

---

ShortText string

A short description of the error.

---

Message string

The message in the response.