---
title: "Update room passive element"
method: PATCH
path: "/v1/objects/{object-id}/floor-plan/passive-elements/{element-id}"
tags: ["Objects"]
---

# Update room passive element

`PATCH /v1/objects/{object-id}/floor-plan/passive-elements/{element-id}`

Update an existing room passive element using merge-patch semantics: only fields present in the request are changed. The element type is immutable. Requires MODIFY access to the room object.

## Path parameters

- `object-id` integer, required
- `element-id` integer, required

## Request body

- RoomPassiveElement — A passive element placed on room floor plan (column, wall, ramp, stairs, door, or other obstruction). On create/update only the writable fields are read; the element type is immutable after creation. Coordinates and dimensions are in millimetres.
  - `id` integer — Element ID (assigned by the server; ignored on input).
  - `name` string
  - `type` 'COLUMN' | 'WALL' | 'RAMP' | 'STAIRS' | 'DOOR' | 'OTHER' — Element type (default OTHER). Immutable after creation.
  - `x` integer — X coordinate of footprint reference corner.
  - `y` integer — Y coordinate of footprint reference corner.
  - `rotation` integer — Rotation in degrees.
  - `width` integer
  - `depth` integer

## Response `200`

Passive element updated

- RoomPassiveElement — A passive element placed on room floor plan (column, wall, ramp, stairs, door, or other obstruction). On create/update only the writable fields are read; the element type is immutable after creation. Coordinates and dimensions are in millimetres.
  - `id` integer — Element ID (assigned by the server; ignored on input).
  - `name` string
  - `type` 'COLUMN' | 'WALL' | 'RAMP' | 'STAIRS' | 'DOOR' | 'OTHER' — Element type (default OTHER). Immutable after creation.
  - `x` integer — X coordinate of footprint reference corner.
  - `y` integer — Y coordinate of footprint reference corner.
  - `rotation` integer — Rotation in degrees.
  - `width` integer
  - `depth` integer

## Other responses

- `400` — Invalid request body, object ID, or object is not a room
- `401` — Unauthorized
- `403` — User does not have modify access to given object
- `404` — Object or passive element with given ID does not exist

## Changes

- **2026-09-21** `2827204d68d9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/objects/:object-id/floor-plan/passive-elements/:element-id/patch.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/0209e896a2a0?raw)