Skip to main content
POST
Reassign device rack slots atomically

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

Input payload for the atomic slot reassignment action.

Every assignment is applied together, so a set that merely passes through an occupied slot — the swap case, where each device wants the other's — is legal even though no single assignment in it is.

max_length documents the intent as much as it bounds the work: the netbox agent submits one 2-device swap, and each assignment costs its own UPDATE inside a single transaction holding row locks until COMMIT.

assignments
object[]
required
Required array length: 1 - 64 elements

Response

Result of an atomic slot reassignment.

devices_changed
integer
required