List Nodes

List inventory nodes with their site/cluster/tenant/node-type assignment.

The import command uses this to preflight hostname collisions and to report drift.

GET /api/admin/inventory/nodes

List Nodes

cURL

curl --request GET \
  --url https://api.primeintellect.ai/api/admin/inventory/nodes \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "role": "<string>",
      "siteId": "<string>",
      "siteSlug": "<string>",
      "isBlankSite": false,
      "gpuCount": 123,
      "publicIp": "<string>",
      "privateIp": "<string>",
      "sshUser": "<string>",
      "nodeTypeId": "<string>",
      "nodeTypeModel": "<string>",
      "nodeTypeSlug": "<string>",
      "activeClusterId": "<string>",
      "activeClusterSlug": "<string>",
      "activeIsController": true,
      "tenantId": "<string>",
      "tenantSlug": "<string>",
      "isUnassigned": false
    }
  ],
  "total_count": 0,
  "offset": 0,
  "limit": 100,
  "status": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

siteId · string | null

Filter to nodes at this inventory site.

clusterId · string | null

Filter to nodes ACTIVE-assigned to this inventory cluster.

search · string | null

Case-insensitive substring match against node name.

offset · integer · default: 0

Number of items to skip.

Required range: x >= 0

limit · integer · default: 50

Max items to return (1-100).

Required range: 1 <= x <= 100

Response

200

application/json

Successful Response

data · InventoryNodeSummary · object[] · required

Show child attributes

total_count · integer · default: 0

Total number of items available in the dataset

offset · integer · default: 0

Number of items to skip before starting to collect the result set

Required range: x >= 0

limit · integer · default: 100

Maximum number of items to return

Required range: x >= 0

status · string | null

Response status