v3

latestOpenAPI 3.1.02026-08-07115219269.8 KB
admin-inventory

Import Inventory Nodes

Create or update inventory nodes in bulk. Optionally assign them to a cluster.

This is an upsert. The service matches a node by (name, siteId). For an existing node, it overwrites the host vars. With ansible_groups, it replaces the cluster additional.ansibleGroups. Because the operation is an upsert, both inventory:create and inventory:update are required and scoped to clusterId. The audit records the acting admin. The prime-admin import command also needs inventory:read for resolution and collision preflight.

post/api/admin/inventory/nodes

Request body

siteIdstring required
clusterIdstring nullable
status'ACTIVE' | 'PLANNED' | 'DECOMMISSIONING' | 'INVENTORY' | 'OFFLINE' | 'FAILED'
role'GPU_NODE' | 'CPU_NODE'
gpuCountinteger nullable
nodeTypeIdstring nullable
ansibleGroupsobject nullable
assignmentType'STANDARD' | 'FAILOVER'
isControllerboolean
priceHrnumber nullable
startDatestring date-time nullable
notesstring nullable
reassignboolean

Response

Successful Response

statusstring nullable

Response status