> ## 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 section > Update an existing section. ## OpenAPI ````json PUT /api/v1/realestateobjects/sections { "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/sections": { "put": { "tags": [ "Sections" ], "summary": "Update a section", "description": "Update an existing section.", "operationId": "UpdateSection", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SectionUpdate" } } } }, "responses": { "200": { "description": "The section was updated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SectionAPIDetailModel" } } } }, "400": { "description": "The section data has validation issues", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/APIErrorMessageModel" } } } } }, "x-d360-narrative-url": "

Update a section

This endpoint updates an existing section.

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

This operation fully overwrites the section. Any field not included in the request will be cleared, not left unchanged. To update only specific fields, first retrieve the section'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 section to update. Either reference or externalIdentifier must be provided. If both are given, the section must match both values. Maximum length 100 characters.

externalIdentifier

string

Conditional

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

name

string

No

Name of the section. Maximum length 256 characters.

categoryName

string

Yes

Category assigned to the section. Maximum length 256 characters.

extraRelations

array of object

No

Additional relations to link to the section. 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 section.

underManagementSince

string (date)

No

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

complexReference

string

Yes

Reference of the complex the section belongs to. Must be an existing complex. Maximum length 100 characters.

address.street

string

Yes

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

address.houseNumber

string

No

House number of the section's address, including any suffix. Can also be used to enter a room number. Maximum length 40 characters.

address.postalCode

string

Yes

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

address.city

string

Yes

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

address.countryISOCode

string

Yes

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

Response Fields

Field

Type

Required

Description

reference

string

No

Internal identifier of the section.

externalIdentifier

string

No

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

name

string

No

Name of the section.

displayName

string

No

Display name of the section, as shown in Bloxs.

ownerReference

string

No

Reference of the owner the section belongs to. Inherited from the complex the section is part of.

categoryName

string

No

Category assigned to the section.

extraRelations

array of object

No

Additional relations linked to the section. 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 section.

underManagementSince

string (date-time)

No

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

salesDate

string (date-time)

No

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

lastModified

string (date-time)

Yes

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

address.street

string

Yes

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

address.houseNumber

string

No

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

address.postalCode

string

Yes

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

address.city

string

Yes

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

address.countryISOCode

string

Yes

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

complexReference

string

No

Reference of the complex the section belongs to.

totalRawFloorArea

number (double)

No

Total raw floor area of all units associated with the section, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

totalRentableFloorArea

number (double)

No

Total rentable floor area of all units associated with the section, in square meters, measured according to the NEN2580 standard. Decimals are separated with a period.

totalUsableFloorArea

number (double)

No

Total usable floor area of all units associated with the section, in square meters.

" } } }, "components": { "schemas": { "SectionUpdate": { "required": [ "address", "categoryName", "complexReference" ], "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 }, "complexReference": { "maxLength": 100, "minLength": 0, "type": "string" }, "address": { "$ref": "#/components/schemas/Address" }, "reference": { "maxLength": 100, "minLength": 0, "type": "string", "nullable": true } }, "additionalProperties": false }, "SectionAPIDetailModel": { "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" }, "complexReference": { "type": "string", "nullable": true }, "totalRawFloorArea": { "type": "number", "format": "double", "nullable": true }, "totalRentableFloorArea": { "type": "number", "format": "double", "nullable": true }, "totalUsableFloorArea": { "type": "number", "format": "double", "nullable": true } }, "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 } } } } ````