Sign in

v57

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-012143051018.3 KB
SKU

Update SKU

Update selected mutable fields on a SKU. The Site is determined from the saved SKU record.

Fields omitted from the request retain their current values. If a user updates the components field, the schema version will be updated to the current version (5).

The Org must have an Infrastructure Provider that owns the SKU's Site. The user must have an authorization role with the PROVIDER_ADMIN suffix.

patch/v2/org/{org}/nico/sku/{skuId}

Request body

descriptionstring

Replacement SKU description

deviceTypestring

Replacement device type identifier

Example request

{
  "description": "DGX H100 compute node with InfiniBand",
  "components": {
    "infinibandDevices": [
      {
        "vendor": "Mellanox Technologies",
        "model": "MT2910 Family [ConnectX-7]",
        "count": 4,
        "inactiveDevices": []
      }
    ]
  }
}

Response

OK

idstring

Unique identifier for the SKU

siteIdstring uuid

ID of the Site this SKU belongs to

descriptionstring

Human-readable SKU description

schemaVersioninteger

Core SKU schema version when available

deviceTypestring nullable

Optional device type identifier (e.g. "gpu", "cpu", "storage")

associatedMachineIdsstring[]

List of machine IDs associated with this SKU

createdstring date-time

ISO 8601 datetime when the SKU was created

updatedstring date-time

ISO 8601 datetime when the SKU was last updated

Example response

{
  "id": "lenovo.sr650v2.cpu.1",
  "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
  "description": "Lenovo SR650 V2 compute node",
  "schemaVersion": 5,
  "deviceType": "gpu",
  "associatedMachineIds": [
    "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g"
  ],
  "components": {
    "cpus": [
      {
        "vendor": "Intel",
        "model": "Xeon Platinum 8480+",
        "threadCount": 112,
        "count": 2
      }
    ],
    "gpus": [
      {
        "vendor": "NVIDIA",
        "model": "H100 SXM5",
        "totalMemory": "80GB HBM3",
        "count": 8
      }
    ],
    "memory": [
      {
        "capacityMb": 65536,
        "memoryType": "DDR5",
        "count": 16
      }
    ],
    "storage": [
      {
        "vendor": "Samsung",
        "model": "PM9A3",
        "capacityMb": 7680000,
        "count": 4
      }
    ],
    "chassis": {
      "vendor": "Supermicro",
      "model": "SYS-420GP-TNR"
    }
  },
  "created": "2019-08-24T14:15:22Z",
  "updated": "2019-08-24T14:15:22Z"
}