Property Deactivation and Activation API

⚠️ This operation affects the live status of the property and its channel connectivity. Use with caution.

This endpoint activates or deactivates a property based on the provided hotel ID, with an option to force deactivation when dependencies exist.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/TogglePropertyStatus

---

Attributes

hotelid string (Required)

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

Maximum 20 characters allowed.

---

is_activate integer (Required)

Indicates whether the property should be activated or deactivated.

Allowed Values:

• 1 → Activate

• 0 → Deactivate

---

force_deactivation boolean (Optional)

This flag applies only when deactivating a property. It has no effect during property activation.

When set to true, all channel passwords associated with the property will be forcefully deactivated and the property itself will be deactivated.

When omitted or set to false, the deactivation request will fail with an error if any channel password associated with the property is still active.

Default: false

Allowed Values:

• If true, the system will deactivate the property regardless of constraints.

• If false, deactivation may fail if blocking conditions exist.

---

Sample Request

{
  "hotelid": "KC",
  "is_active": 0,
  "force_deactivation": false
}

---

Response

Sample Success Response

{
    "Status": "Success",
    "Message": "Property Status Deactivated Successfully"
}

---

Success Response - Body Elements

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.

---

Message string

The message in the response.

Message: Property Status Deactivated Successfully

---

Error

Sample Error Response

Error 1

{
    "Errors": {
        "Code": "400",
        "ShortText": "hotelid/hotel_id/ClientID: Invalid HotelCode (KC)"
    },
    "Status": "Fail"
}

Error 2

---

Error Response Body Elements

Response Body Elements

Error object

The error response data, 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.

---

Status string

Indicates the result of the API call.

Will be "Fail" for failed operations.