> ## Documentation Index > Fetch the complete documentation index at: https://docs.kodelabs.com/llms.txt > Use this file to discover all available pages before exploring further. # Create space units > Creates one or more space units in a building in one call. > [!NOTE] > > Send the building as the `buildingId` query parameter too. Use the same building as in the path. > [!NOTE] > > Each space unit needs a `name` and a `partOfId`, the level or space it belongs to. The `partOfId` must be in this building. Names must be unique in the request. The response is `200`. `insertedIds` maps the position of each space unit in your request, starting at `0`, to the id of the new space unit. ## OpenAPI ````yaml /openapi/kode-api.yaml post /api/v1/buildings/{buildingId}/spaces/space-units openapi: 3.1.0 info: title: KODE API version: 1.0.0 summary: Programmatic access to KODE OS resources and operations. description: > Use the KODE API to work with buildings, data sources, connectors, devices, points, virtual devices, timeseries data, schedules, the ontology, templating, mass writes, spaces, space assignments, tenants, meters, users, actions, and AssetOps work orders. license: name: Proprietary identifier: LicenseRef-Proprietary servers: - url: https://api.kodelabs.com/kodeos description: KODE API security: - bearerAuth: [] tags: - name: Authentication description: OAuth 2.0 discovery, token, and revocation endpoints. - name: Buildings description: Buildings and their areas. - name: Data sources description: Data sources connected to a building. - name: Devices description: Devices and their points. - name: Points description: Point queries and point writes. - name: Timeseries description: Current and historical point values. - name: Actions description: Actions exposed by building data sources. - name: Work orders description: AssetOps work orders, lookups, comments, and attachments. - name: Connectors description: KODE API connectors and the devices and points ingested through them. - name: Schedules description: Schedules discovered on building data sources. - name: Templating description: Apply ontology templates to groups of points. - name: Virtual devices description: Virtual devices that group points from other devices. - name: Ontology description: Canonical types, fields, units, and connections of the KODE ontology. - name: Users description: Users of the organization and their app access. - name: Mass write description: Write values to many points across buildings, and follow each run. - name: Spaces description: Levels and space units of a building, and the meters located in them. - name: Space assignments description: Assign tenants to leasable spaces of a building for a period. - name: Tenants description: Tenants of a building, the people or companies that lease its spaces. - name: Meters description: >- Meters of a building, their space assignments, parent and child links, and readings. paths: /api/v1/buildings/{buildingId}/spaces/space-units: post: tags: - Spaces summary: Create space units description: Creates one or more space units in a building in one call. operationId: createSpaceUnits parameters: - $ref: '#/components/parameters/BuildingId' - name: buildingId in: query required: true schema: type: string pattern: \S description: Identifier of the building. Use the same building as in the path. requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateSpaceUnitsRequest' required: true responses: '200': description: The space units were created. content: application/json: schema: $ref: '#/components/schemas/InsertManyResult' '400': description: >- `spaceUnits` is missing or empty, a name or `partOfId` is missing or blank, `partOfId` does not exist or is in another building, a name is used twice, a value has the wrong type, `operationalStatus` or `workpoint` is not one of the listed values, a measurement has no `unit`, or the query `buildingId` is missing or blank. '401': $ref: '#/components/responses/Unauthorized' '403': description: >- The building does not exist or is not assigned to the service account. '429': $ref: '#/components/responses/TooManyRequests' components: parameters: BuildingId: name: buildingId in: path required: true description: Building identifier from List buildings. schema: type: string example: 67c960faffaa42223163099e schemas: CreateSpaceUnitsRequest: type: object required: - spaceUnits properties: spaceUnits: description: >- Space units to create. At least one. Names must be unique in the request. type: array items: $ref: '#/components/schemas/CreateSpaceUnitItem' minItems: 1 InsertManyResult: type: object properties: insertedIds: description: >- Identifiers of the new spaces. Each key is the position of the item in your request, starting at `0`. type: object additionalProperties: type: string CreateSpaceUnitItem: type: object required: - name - partOfId properties: name: description: Name of the space unit. Required. type: string pattern: \S description: type: string operationalStatus: description: >- One of `active`, `inactive`, `under_maintenance`, `under_construction`, `decommissioned`, or `excluded`. type: string area: $ref: '#/components/schemas/DoubleMeasurementPayload1' description: Measurement with a `value` and a `unit` symbol, for example `m²`. netArea: $ref: '#/components/schemas/DoubleMeasurementPayload1' description: Measurement with a `value` and a `unit` symbol, for example `m²`. height: $ref: '#/components/schemas/DoubleMeasurementPayload1' description: Measurement with a `value` and a `unit` symbol, for example `m²`. baseTemperature: $ref: '#/components/schemas/DoubleMeasurementPayload1' description: Measurement with a `value` and a `unit` symbol, for example `m²`. baseHumidity: $ref: '#/components/schemas/DoubleMeasurementPayload1' description: Measurement with a `value` and a `unit` symbol, for example `m²`. baseAirQuality: $ref: '#/components/schemas/DoubleMeasurementPayload1' description: Measurement with a `value` and a `unit` symbol, for example `m²`. baseNoiseLevel: $ref: '#/components/schemas/DoubleMeasurementPayload1' description: Measurement with a `value` and a `unit` symbol, for example `m²`. targetUtilization: $ref: '#/components/schemas/DoubleMeasurementPayload1' description: Measurement with a `value` and a `unit` symbol, for example `m²`. headcount: type: integer format: int32 capacity: type: integer format: int32 seatingCapacity: type: integer format: int32 allocated: type: boolean identifier: description: Your own identifier for the space unit. type: string partOfId: description: >- Identifier of the level or space this space unit belongs to. It must be in this building. Required. type: string pattern: \S usage: description: Usage of the space unit, for example `work_spaces`. type: string type: description: >- Type of the space unit, for example `office`. The type must belong to the `usage`. type: string tenantUnit: description: Whether the space can be let to a tenant. type: boolean leasable: type: boolean shared: type: boolean bookable: type: boolean workpoint: description: One of `primary`, `alternative`, or `none`. type: string assignmentCapacity: type: integer format: int32 seatingModel: type: string displayName: type: string DoubleMeasurementPayload1: type: object properties: value: description: Numeric value. type: number format: double unit: description: Unit symbol, for example `m²`. Required when you send a value. type: string responses: Unauthorized: description: The access token is missing, invalid, or expired. Request a new token. TooManyRequests: description: >- A rate-limit window is exhausted. Wait, then retry with increasing delays. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Paste an access token from [Create an access token](/products/kode-api/api-reference/authentication/create-an-access-token). Tokens expire, so request a new one if you receive `401`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.