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

# Create rack passive element

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

Add a new passive element (patch panel, filler panel, organiser, or PDU) to a rack. The server assigns the element identifier. Requires MODIFY access to the rack object.

## Path parameters

- `object-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 `201`

Passive element created

- 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 with given ID does not exist

## Changes

> 71 revisions in range; 5 could not be searched.

- **2026-07-14** `6c7a0c985250` — 1 info
  - endpoint added
- **2026-05-08** `c6aaf3632e48` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/objects/:object-id/rack-layout/passive-elements/post.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-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-api/revisions/b04ea2fbcedb/schema)