Skip to main content
PUT
Update a space
Send every value you want the space to keep, not only the ones that change. Read the space with Get a space and send it back with your changes.
The body must hold the same buildingId as the path. Renaming a level to the name of another level in the building fails with 400.

Authorizations

Authorization
string
header
required

Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.

Path Parameters

spaceId
string
required

Identifier of the space to update.

Body

application/json
buildingId
string
required

Identifier of the building. Use the same building as in the path. Required.

Pattern: \S
name
string

Name of the space.

description
string

Description of the space.

displayName
string

Name shown in KODE OS.

operationalStatus
string

One of active, inactive, under_maintenance, under_construction, decommissioned, or excluded.

area
object

Measurement with a value and a unit symbol, for example m².

netArea
object

Measurement with a value and a unit symbol, for example m².

height
object

Measurement with a value and a unit symbol, for example m².

capacity
integer<int32>
seatingCapacity
integer<int32>
headcount
integer<int32>
allocated
boolean
baseTemperature
object

Measurement with a value and a unit symbol, for example m².

baseHumidity
object

Measurement with a value and a unit symbol, for example m².

baseAirQuality
object

Measurement with a value and a unit symbol, for example m².

baseNoiseLevel
object

Measurement with a value and a unit symbol, for example m².

targetUtilization
object

Measurement with a value and a unit symbol, for example m².

identifier
string

Your own identifier for the space.

usage
string
type
string
tenantUnit
boolean

Whether the space can be let to a tenant. Setting it to true also sets leasable to true.

leasable
boolean
shared
boolean
bookable
boolean
workpoint
string

Workpoint of a space unit. One of primary, alternative, or none.

assignmentCapacity
integer<int32>
seatingModel
string

Response

The updated space.

_id
string

Space identifier.

organizationId
string
createdAt
string
read-only

Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.

Example:

"2026-10-28T13:51:31+0000"

updatedAt
string
read-only

Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.

Example:

"2026-10-28T13:51:31+0000"

name
string
description
string
displayName
string
category
string

Level, SpaceUnit, or Zone.

partOf
object

The level or space this space belongs to.

inZone
object[]

Zones the space is in.

area
object
netArea
object
height
object
capacity
integer<int32>
seatingCapacity
integer<int32>
headcount
integer<int32>
allocated
boolean
baseTemperature
object
baseHumidity
object
baseAirQuality
object
baseNoiseLevel
object
targetUtilization
object
building
object

The building of the space.

devicesCount
integer<int32>

Number of devices in the space.

identifier
string
operationalStatus
string

Operational status of the space.

usage
string
type
string
tenantUnit
boolean
leasable
boolean
shared
boolean
bookable
boolean
workpoint
string
assignmentCapacity
integer<int32>
seatingModel
string