> ## Documentation Index > Fetch the complete documentation index at: https://www.bloxs.io/llms.txt > Use this file to discover all available pages before exploring further. # Update a building > Update an existing building. ## OpenAPI ````json PUT /api/v1/realestateobjects/buildings { "openapi": "3.0.4", "info": { "title": "RealEstateObjects V1", "description": "Welcome to BETA version of the new RealEstateObjects API - intended for client public testing before the launch of the final version. During this BETA phase, we'll be improving the API based on specific client's feedbacks.", "version": "v1" }, "security": [ {} ], "tags": [ { "name": "Admin" }, { "name": "Buildings" }, { "name": "Complexes" }, { "name": "Generic" }, { "name": "Metadata" }, { "name": "PublishObjects" }, { "name": "ScoringPointTotals" }, { "name": "Sections" }, { "name": "Units" } ], "paths": { "/api/v1/realestateobjects/buildings": { "put": { "tags": [ "Buildings" ], "summary": "Update a building", "description": "Update an existing building.", "operationId": "UpdateBuilding", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuildingUpdate" } } } }, "responses": { "200": { "description": "The building was updated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BuildingAPIDetailModel" } } } }, "400": { "description": "The building data has validation issues", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/APIErrorMessageModel" } } } } }, "x-d360-narrative-url": "

Update a building

This endpoint updates an existing building.

The building to update is identified by its internal reference, its external identifier, or both. If both are given, they must refer to the same building, otherwise the request fails.

This operation fully overwrites the building. Any field not included in the request will be cleared, not left unchanged. To update only specific fields, first retrieve the building's current data and include all existing values in the request together with the changes.

Request Fields

Field

Type

Required

Description

reference

string

Conditional

Internal identifier of the building to update. Either reference or externalIdentifier must be provided. If both are given, the building must match both values. Maximum length 100 characters.

externalIdentifier

string

Conditional

External identifier of the building to update, as set by the integrating system. Either reference or externalIdentifier must be provided. If both are given, the building must match both values. Maximum length 100 characters.

name

string

No

Name of the building. Maximum length 256 characters.

categoryName

string

Yes

Category assigned to the building. The category describes the type of object and indicates its purpose, for example house, office, or shop. Category values are configurable in the Bloxs admin module and determine the divisibility rules of the building. Maximum length 256 characters.

extraRelations

array of object

No

Additional relations to link to the building. Only existing relations can be linked.

extraRelations.extraRelationTypeName

string

No

Relation type to assign to the linked party for this object.

extraRelations.relationReference

string

No

Reference of the relation to link. Must correspond to an existing relation already registered in Bloxs.

remarks

string

No

Free text remarks to store on the building.

underManagementSince

string (date)

No

Date the building came under management. ISO 8601 format, for example 2026-01-01.

ownerReference

string

Yes

Reference of the owner the building belongs to. A building can have only one owner.

address.street

string

Yes

Street name of the building's address. Maximum length 200 characters.

address.houseNumber

string

No

House number of the building's address, including any suffix. Maximum length 40 characters.

address.postalCode

string

Yes

Postal code of the building's address. Maximum length 20 characters.

address.city

string

Yes

City of the building's address. Maximum length 200 characters.

address.countryISOCode

string

Yes

ISO 3166-1 alpha-2 country code of the building's address. Maximum length 2 characters.

regionName

string

No

Region to assign the building to. Maximum length 256 characters.

rawFloorArea

number (double)

No

Raw floor area of the building, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period. Minimum 0.01.

rentableFloorArea

number (double)

No

Rentable floor area of the building, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period. Minimum 0.01.

usableFloorArea

number (double)

No

Usable floor area of the building, in square meters. Minimum 0.01.

energyIndex

number (double)

No

Energy index of the building.

estateAgentReference

string

No

Reference of the estate agent associated with the building. Must be an existing relation. A building can have only one estate agent.

technicalManagement

boolean

No

Indicates whether the building is under technical management. Default value is false when omitted.

financialManagement

boolean

No

Indicates whether the building is under financial management. Default value is false when omitted.

mandateAmount

number (double)

No

Mandate amount related to technical management. It indicates the limit up to which the manager may approve repairs and maintenance costs before requiring the owner's approval.

constructionYear

integer

No

Year the building was constructed.

divisibleInfo.divisibleType

integer

Yes (within divisibleInfo)

Divisibility type of the building. Valid values are 1 (SingleUnit), 2 (DivisibleByUnits), or 3 (DivisibleByFloorArea).

divisibleInfo.divisibleFloorAreaType

integer

No

Floor area type used when divisibleType is DivisibleByFloorArea. Valid values are 0 (NA), 1 (RawFloorArea), 2 (RentableFloorArea), or 3 (UsableFloorArea).

divisibleInfo.divisibleValue

number (double)

No

Threshold value used together with divisibleFloorAreaType to determine divisibility.

Response Fields

Field

Type

Required

Description

reference

string

No

Internal identifier of the building.

externalIdentifier

string

No

External identifier of the building, as set by the integrating system.

name

string

No

Name of the building.

displayName

string

No

Display name of the building, as shown in Bloxs.

ownerReference

string

No

Reference of the owner the building belongs to.

categoryName

string

No

Category assigned to the building.

extraRelations

array of object

No

Additional relations linked to the building. Empty or omitted when no extra relations are set.

extraRelations.extraRelationTypeName

string

No

Relation type assigned to the linked party for this object.

extraRelations.relationReference

string

No

Reference of the linked relation.

remarks

string

No

Free text remarks stored on the building.

underManagementSince

string (date-time)

No

Date the building came under management. ISO 8601 format, for example 2026-01-01T00:00:00.

salesDate

string (date-time)

No

Date the building was sold, if applicable. ISO 8601 format.

lastModified

string (date-time)

Yes

Date and time the building was last modified. ISO 8601 format, UTC.

address.street

string

Yes

Street name of the building's address. Maximum length 200 characters.

address.houseNumber

string

No

House number of the building's address, including any suffix. Maximum length 40 characters.

address.postalCode

string

Yes

Postal code of the building's address. Maximum length 20 characters.

address.city

string

Yes

City of the building's address. Maximum length 200 characters.

address.countryISOCode

string

Yes

ISO 3166-1 alpha-2 country code of the building's address. Maximum length 2 characters.

regionName

string

No

Region the building is assigned to.

rawFloorArea

number (double)

No

Raw floor area of the building, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

rentableFloorArea

number (double)

No

Rentable floor area of the building, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

usableFloorArea

number (double)

No

Usable floor area of the building, in square meters.

energyIndex

number (double)

No

Energy index of the building.

estateAgentReference

string

No

Reference of the estate agent associated with the building.

technicalManagement

boolean

Yes

Indicates whether the building is under technical management.

financialManagement

boolean

Yes

Indicates whether the building is under financial management.

mandateAmount

number (double)

No

Mandate amount related to technical management, indicating the limit up to which the manager may approve repairs and maintenance costs before requiring the owner's approval.

constructionYear

integer

No

Year the building was constructed.

isDivisible

boolean

Yes

Indicates whether the building can be divided into rentable units. Derived from the assigned category.

divisibleInfo.divisibleType

integer

Yes

Divisibility type of the building. Valid values are 1 (SingleUnit), 2 (DivisibleByUnits), or 3 (DivisibleByFloorArea).

divisibleInfo.divisibleFloorAreaType

integer

No

Floor area type used when divisibleType is DivisibleByFloorArea. Valid values are 0 (NA), 1 (RawFloorArea), 2 (RentableFloorArea), or 3 (UsableFloorArea).

divisibleInfo.divisibleValue

number (double)

No

Threshold value used together with divisibleFloorAreaType to determine divisibility.

" } } }, "components": { "schemas": { "BuildingUpdate": { "required": [ "address", "categoryName", "ownerReference" ], "type": "object", "properties": { "externalIdentifier": { "maxLength": 100, "minLength": 0, "type": "string", "nullable": true }, "name": { "maxLength": 256, "minLength": 0, "type": "string", "nullable": true }, "categoryName": { "maxLength": 256, "minLength": 0, "type": "string" }, "extraRelations": { "type": "array", "items": { "$ref": "#/components/schemas/RealEstateExtraRelationAPIModel" }, "nullable": true }, "remarks": { "type": "string", "nullable": true }, "underManagementSince": { "type": "string", "format": "date", "nullable": true }, "ownerReference": { "minLength": 1, "type": "string" }, "address": { "$ref": "#/components/schemas/Address" }, "regionName": { "maxLength": 256, "minLength": 0, "type": "string", "nullable": true }, "rawFloorArea": { "maximum": 2147483647, "minimum": 0.01, "type": "number", "format": "double", "nullable": true }, "rentableFloorArea": { "maximum": 2147483647, "minimum": 0.01, "type": "number", "format": "double", "nullable": true }, "usableFloorArea": { "maximum": 2147483647, "minimum": 0.01, "type": "number", "format": "double", "nullable": true }, "energyIndex": { "maximum": 2147483647, "minimum": 0, "type": "number", "format": "double", "nullable": true }, "estateAgentReference": { "type": "string", "nullable": true }, "technicalManagement": { "type": "boolean" }, "financialManagement": { "type": "boolean" }, "mandateAmount": { "type": "number", "format": "double", "nullable": true }, "constructionYear": { "type": "integer", "format": "int32", "nullable": true }, "divisibleInfo": { "$ref": "#/components/schemas/DivisibleInfo" }, "reference": { "maxLength": 100, "minLength": 0, "type": "string", "nullable": true } }, "additionalProperties": false }, "BuildingAPIDetailModel": { "type": "object", "properties": { "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "displayName": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "categoryName": { "type": "string", "nullable": true }, "extraRelations": { "type": "array", "items": { "$ref": "#/components/schemas/RealEstateExtraRelationAPIModel" }, "nullable": true }, "remarks": { "type": "string", "nullable": true }, "underManagementSince": { "type": "string", "format": "date-time", "nullable": true }, "salesDate": { "type": "string", "format": "date-time", "nullable": true }, "lastModified": { "type": "string", "format": "date-time" }, "address": { "$ref": "#/components/schemas/Address" }, "regionName": { "type": "string", "nullable": true }, "rawFloorArea": { "type": "number", "format": "double", "nullable": true }, "rentableFloorArea": { "type": "number", "format": "double", "nullable": true }, "usableFloorArea": { "type": "number", "format": "double", "nullable": true }, "energyIndex": { "type": "number", "format": "double", "nullable": true }, "estateAgentReference": { "type": "string", "nullable": true }, "technicalManagement": { "type": "boolean" }, "financialManagement": { "type": "boolean" }, "mandateAmount": { "type": "number", "format": "double", "nullable": true }, "constructionYear": { "type": "integer", "format": "int32", "nullable": true }, "isDivisible": { "type": "boolean" }, "divisibleInfo": { "$ref": "#/components/schemas/DivisibleInfo" } }, "additionalProperties": false }, "APIErrorMessageModel": { "type": "object", "properties": { "type": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "traceId": { "type": "string", "nullable": true }, "status": { "type": "integer", "format": "int32" }, "errors": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" }, "nullable": true }, "nullable": true } }, "additionalProperties": false }, "RealEstateExtraRelationAPIModel": { "type": "object", "properties": { "extraRelationTypeName": { "type": "string", "nullable": true }, "relationReference": { "type": "string", "nullable": true } }, "additionalProperties": false }, "Address": { "required": [ "city", "countryISOCode", "postalCode", "street" ], "type": "object", "properties": { "street": { "maxLength": 200, "minLength": 0, "type": "string" }, "houseNumber": { "maxLength": 40, "minLength": 0, "type": "string", "nullable": true }, "postalCode": { "maxLength": 20, "minLength": 0, "type": "string" }, "city": { "maxLength": 200, "minLength": 0, "type": "string" }, "countryISOCode": { "maxLength": 2, "minLength": 0, "type": "string" } }, "additionalProperties": false }, "DivisibleInfo": { "required": [ "divisibleType" ], "type": "object", "properties": { "divisibleType": { "type": "integer", "description": "SingleUnit = 1\nDivisibleByUnits = 2\nDivisibleByFloorArea = 3", "format": "int32", "x-enumNames": [ "SingleUnit", "DivisibleByUnits", "DivisibleByFloorArea" ] }, "divisibleFloorAreaType": { "type": "integer", "description": "NA = 0\nRawFloorArea = 1\nRentableFloorArea = 2\nUsableFloorArea = 3", "format": "int32", "nullable": true, "x-enumNames": [ "NA", "RawFloorArea", "RentableFloorArea", "UsableFloorArea" ] }, "divisibleValue": { "maximum": 2147483647, "minimum": 0, "type": "number", "format": "double", "nullable": true } }, "additionalProperties": false } } } } ````