Update publication data of a real estate object.
Update publication data
This endpoint updates the publication status of a real estate object that is currently published.
The object is identified by its internal reference, its external identifier, or both. If both are given, they must refer to the same object, otherwise the request fails.
It is intentionally limited to the publish status and availability, and fully overwrites those fields with the data provided in the request. It does not update the object's other published details.
Request Fields
Field | Type | Required | Description |
|---|---|---|---|
reference | string | Conditional | Internal identifier of the object. Either reference or externalIdentifier must be provided. If both are given, the object must match both values. |
externalIdentifier | string | Conditional | External identifier of the object, as set by the integrating system. Either reference or externalIdentifier must be provided. If both are given, the object must match both values. |
isPublished | boolean | Yes | Indicates whether the object should be published. |
publishedDate | string (date) | No | Date the object was initially published. ISO 8601 format. |
publishedStatus | integer | Yes | Publication status of the object. Valid values are 0 (Available), 1 (Reserved), 2 (Rented), or 3 (UnderOption). |
availableFrom | string (date-time) | No | Date and time from which the object is available. ISO 8601 format. |
Response Fields
Field | Type | Required | Description |
|---|---|---|---|
reference | string | No | Internal identifier of the object. |
externalIdentifier | string | No | External identifier of the object. |
isPublished | boolean | Yes | Indicates whether the object is published. |
publishedDate | string (date) | No | Date the object was initially published. |
publishedStatus | integer | Yes | Publication status of the object. Valid values are 0 (Available), 1 (Reserved), 2 (Rented), or 3 (UnderOption). |
availableFrom | string (date-time) | No | Date and time from which the object is available. |
Available = 0 Reserved = 1 Rented = 2 UnderOption = 3
The publication data for real estate object was updated
Available = 0 Reserved = 1 Rented = 2 UnderOption = 3
The requested real estate object was not found.