Get started

Nodes

List and inspect bare-metal nodes registered with NodeFoundry.

List Nodes

GET /nodes

Returns all registered nodes with basic metadata.

Response
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "hostname": "worker-01",
    "role": "worker",
    "ip": "10.0.0.10",
    "createdAt": "2026-03-15T10:30:00Z"
  }
]

Node Details

GET /nodes/details

Returns all nodes with full Ceph daemon state, including which daemons are assigned and disk/OSD counts.

Response fields

id UUID
Node identifier
hostname string
Node hostname
role string
master or worker
ip string
Node IP address
status string
Current node status
hasMon bool
Node has a Ceph Monitor assigned
hasMgr bool
Node has a Ceph Manager assigned
hasMds bool
Node has a Ceph MDS assigned
hasRgw bool
Node has a RADOS Gateway assigned
monExists bool
Monitor daemon is running
mgrExists bool
Manager daemon is running
mdsExists bool
MDS daemon is running
rgwExists bool
RGW daemon is running
diskCount int
Total disks on the node
osdCount int
Number of OSDs on the node
Response
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "hostname": "worker-01",
    "role": "worker",
    "ip": "10.0.0.10",
    "status": "active",
    "hasMon": true,
    "hasMgr": false,
    "hasMds": false,
    "hasRgw": false,
    "monExists": true,
    "mgrExists": false,
    "mdsExists": false,
    "rgwExists": false,
    "diskCount": 4,
    "osdCount": 3
  }
]