Add, update or remove property-level facilities

Request

Add or update single or multi-instances facilities using this endpoint. Try the available request examples in the specification.

To delete a facility or all instances of a multi-instance facility (for example: all parking facility), you can change the facility state to MISSING.

Important — overlay semantics for multi-instance facilities: This endpoint replaces the full set of instances for any facility you include in the request. If you omit an existing instance, it is permanently deleted. Facility types not included in the request are unaffected.

Before updating a multi-instance facility (Parking, Restaurant, Swimming Pool), call GET /facilities-api/properties/{propertyId} to retrieve the current instance IDs for that facility, then include all of them alongside your changes in the PUT body. To add a new instance without disturbing existing ones, include the existing instances with their instance_id values plus the new instance (without an instance_id).

Path

propertyIdintegerrequired

Bodyapplication/jsonrequired

Array [

facility_idinteger, (int32)required

Property Facility ID

instancesArray of objects(InstanceRequest)

Array of instances

statestringrequired

Is facility Present/Missing?

Enum:"MISSING""PRESENT"

]

curl -i -X PUT \
  'https://developers.booking.com/_mock/connectivity/docs/openapispecs/facilities-api/facilities-api-specification/facilities-api/properties/{propertyId}' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "facility_id": 418,
      "state": "PRESENT"
    },
    {
      "facility_id": 419,
      "state": "MISSING"
    }
  ]'

Responses

OK

Bodyapplication/json

dataobject(SuccessObject)

warningsArray of any, <= 0 items

errorsArray of any, <= 0 items

metaobject(ResponseMeta)

Response

{
  "data": {
    "success": true
  },
  "warnings": [],
  "errors": [],
  "meta": {
    "ruid": "string"
  }
}