> ## 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. # Update a space > Changes the details of a space. > [!WARNING] > > Send every value you want the space to keep, not only the ones that change. Read the space with [Get a space](https://docs.kodelabs.com/products/kode-api/api-reference/spaces/get-a-space.md) and send it back with your changes. > [!NOTE] > > 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`. ## OpenAPI ````yaml /openapi/kode-api.yaml put /api/v1/buildings/{buildingId}/spaces/{spaceId} 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/{spaceId}: put: tags: - Spaces summary: Update a space description: Changes the details of a space. operationId: updateSpace parameters: - name: spaceId in: path required: true schema: type: string description: Identifier of the space to update. requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateSpaceRequest' required: true responses: '200': description: The updated space. content: application/json: schema: $ref: '#/components/schemas/SpacePublic' '400': description: >- The body is empty, a field is empty or has the wrong type, or a level is renamed to a name another level already has. '401': $ref: '#/components/responses/Unauthorized' '403': description: >- The building does not exist or is not assigned to the service account. '404': description: No space with this `spaceId` exists. '429': $ref: '#/components/responses/TooManyRequests' components: schemas: UpdateSpaceRequest: type: object required: - buildingId properties: buildingId: description: >- Identifier of the building. Use the same building as in the path. Required. type: string pattern: \S name: description: Name of the space. type: string description: description: Description of the space. type: string displayName: description: Name shown in KODE OS. 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²`. capacity: type: integer format: int32 seatingCapacity: type: integer format: int32 headcount: type: integer format: int32 allocated: type: boolean 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²`. identifier: description: Your own identifier for the space. type: string usage: type: string type: type: string tenantUnit: description: >- Whether the space can be let to a tenant. Setting it to `true` also sets `leasable` to `true`. type: boolean leasable: type: boolean shared: type: boolean bookable: type: boolean workpoint: description: >- Workpoint of a space unit. One of `primary`, `alternative`, or `none`. type: string assignmentCapacity: type: integer format: int32 seatingModel: type: string SpacePublic: type: object properties: _id: description: Space identifier. type: string organizationId: type: string createdAt: $ref: '#/components/schemas/Date' type: string readOnly: true updatedAt: $ref: '#/components/schemas/Date' type: string readOnly: true name: type: string description: type: string displayName: type: string category: description: '`Level`, `SpaceUnit`, or `Zone`.' type: string partOf: $ref: '#/components/schemas/SpaceRef2' description: The level or space this space belongs to. inZone: description: Zones the space is in. type: array items: $ref: '#/components/schemas/SpaceRef2' area: $ref: '#/components/schemas/DoubleMeasurement2' netArea: $ref: '#/components/schemas/DoubleMeasurement2' height: $ref: '#/components/schemas/DoubleMeasurement2' capacity: type: integer format: int32 seatingCapacity: type: integer format: int32 headcount: type: integer format: int32 allocated: type: boolean baseTemperature: $ref: '#/components/schemas/DoubleMeasurement2' baseHumidity: $ref: '#/components/schemas/DoubleMeasurement2' baseAirQuality: $ref: '#/components/schemas/DoubleMeasurement2' baseNoiseLevel: $ref: '#/components/schemas/DoubleMeasurement2' targetUtilization: $ref: '#/components/schemas/DoubleMeasurement2' building: $ref: '#/components/schemas/PublicBuildingRef' description: The building of the space. devicesCount: description: Number of devices in the space. type: integer format: int32 identifier: type: string operationalStatus: description: Operational status of the space. type: string usage: type: string type: type: string tenantUnit: type: boolean leasable: type: boolean shared: type: boolean bookable: type: boolean workpoint: type: string assignmentCapacity: type: integer format: int32 seatingModel: 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 Date: type: string description: >- Date and time in UTC, with a numeric offset and no colon, for example `2026-10-28T13:51:31+0000`. examples: - 2026-10-28T13:51:31+0000 SpaceRef2: type: object properties: id: type: string name: type: string category: type: string DoubleMeasurement2: type: object properties: value: type: number format: double unit: $ref: '#/components/schemas/PublicUnit' PublicBuildingRef: type: object properties: _id: type: string name: type: string PublicUnit: type: object properties: _id: type: string category: type: string baseSymbol: type: string symbol: 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.