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

# Update rack passive element

`PATCH /v1/objects/{object-id}/rack-layout/passive-elements/{element-id}`

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

## Path parameters

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

## Request body

- RackPassiveElement — A passive rack element (patch panel, filler panel, organiser, or PDU). On create/update only the writable fields are read; the element type is immutable after creation.
  - `id` integer — Element ID (assigned by the server; ignored on input).
  - `name` string — Element name.
  - `type` integer — Element type (0=patch panel, 1=filler panel, 2=organiser, 3=PDU). Immutable on update.
  - `position` integer — Position in rack units.
  - `height` integer — Height in rack units.
  - `orientation` integer — Orientation (0=fill, 1=front, 2=rear).
  - `portCount` integer — Number of ports (patch panels only).
  - `imageFront` string, uuid — Front image UUID from the image library.
  - `imageRear` string, uuid — Rear image UUID from the image library.

## Response `200`

Passive element updated

- RackPassiveElement — A passive rack element (patch panel, filler panel, organiser, or PDU). On create/update only the writable fields are read; the element type is immutable after creation.
  - `id` integer — Element ID (assigned by the server; ignored on input).
  - `name` string — Element name.
  - `type` integer — Element type (0=patch panel, 1=filler panel, 2=organiser, 3=PDU). Immutable on update.
  - `position` integer — Position in rack units.
  - `height` integer — Height in rack units.
  - `orientation` integer — Orientation (0=fill, 1=front, 2=rear).
  - `portCount` integer — Number of ports (patch panels only).
  - `imageFront` string, uuid — Front image UUID from the image library.
  - `imageRear` string, uuid — Rear image UUID from the image library.

## Other responses

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

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/versions/14d93e5115dd/schema)