> ## 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. # Insert a section > Insert a new section. ## OpenAPI ````json POST /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": { "post": { "tags": [ "Sections" ], "summary": "Insert a section", "description": "Insert a new section.", "operationId": "InsertSection", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Section" } } } }, "responses": { "200": { "description": "The section was created", "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": "

Insert a section

This endpoint creates a new section within an existing complex.

A section represents a building section, the object Bloxs uses to subdivide a complex into distinct parts that can each be managed and let separately. Developers call this endpoint when onboarding or synchronising real estate data, for example when a new building section becomes available for management and its address, category and complex link need to be registered in Bloxs.

The complex referenced in complexReference must already exist.

Request Fields

Field

Type

Required

Description

externalIdentifier

String (max 100 characters)

Optional

External identifier for the section, supplied by the caller. Can be used instead of reference to look up the section in other endpoints.

name

String (max 256 characters)

Optional

Name of the section.

categoryName

String (max 256 characters)

Required

Category the section is classified under. The available category names can be retrieved through the \"Get a list of categories\" endpoint.

extraRelations

Array of objects

Optional

Additional relations linked to the section, beyond the owner. Each entry links a relation to an extra relation type.

extraRelations[].extraRelationTypeName

String

Optional

Name of the extra relation type. The available extra relation type names can be retrieved through the \"Get a list of extra relation types\" endpoint.

extraRelations[].relationReference

String

Optional

Reference to the relation linked to the section under this extra relation type.

remarks

String

Optional

Free-text remarks about the section.

underManagementSince

Date (ISO 8601, format YYYY-MM-DD)

Optional

Date from which the section is under management. Example: 2026-01-01.

complexReference

String (max 100 characters)

Required

Reference to the complex the section belongs to.

address.street

String (max 200 characters)

Required

Street name of the section's address.

address.houseNumber

String (max 40 characters)

Optional

House number of the section's address.

address.postalCode

String (max 20 characters)

Required

Postal code of the section's address.

address.city

String (max 200 characters)

Required

City of the section's address.

address.countryISOCode

String (max 2 characters)

Required

Country of the section's address, as an ISO 3166-1 alpha-2 country code. Example: NL.

Response Fields

Field

Type

Required

Description

reference

String

Required

Internal identifier of the section, assigned by Bloxs on creation.

externalIdentifier

String

Optional

External identifier of the section, as supplied by the caller on creation.

name

String

Optional

Name of the section.

displayName

String

Optional

Display name of the section as shown in Bloxs. Read only.

ownerReference

String

Optional

Reference to the owner, the administration the section is registered under.

categoryName

String

Required

Category the section is classified under.

extraRelations

Array of objects

Optional

Additional relations linked to the section, beyond the owner.

extraRelations[].extraRelationTypeName

String

Optional

Name of the extra relation type.

extraRelations[].relationReference

String

Optional

Reference to the relation linked to the section under this extra relation type.

remarks

String

Optional

Free-text remarks about the section.

underManagementSince

Date and time (ISO 8601, UTC)

Optional

Date and time from which the section is under management. Example: 2026-01-01T00:00:00Z.

salesDate

Date and time (ISO 8601, UTC)

Optional

Date and time the section was sold. Only present once the section has been sold. Example: 2026-06-15T00:00:00Z.

lastModified

Date and time (ISO 8601, UTC)

Required

Date and time the section was last modified. Example: 2026-09-16T14:30:00Z.

address.street

String

Required

Street name of the section's address.

address.houseNumber

String

Optional

House number of the section's address.

address.postalCode

String

Required

Postal code of the section's address.

address.city

String

Required

City of the section's address.

address.countryISOCode

String

Required

Country of the section's address, as an ISO 3166-1 alpha-2 country code. Example: NL.

complexReference

String

Required

Reference to the complex the section belongs to.

totalRawFloorArea

Decimal

Optional

Total gross floor area (GFA) of the section, aggregated from its units.

totalRentableFloorArea

Decimal

Optional

Total net lettable area (NLA) of the section, aggregated from its units.

totalUsableFloorArea

Decimal

Optional

Total usable floor area (UFA) of the section, aggregated from its units.

" } } }, "components": { "schemas": { "Section": { "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" } }, "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 } } } } ````