---
title: "Update Nodes"
method: PATCH
path: "/api/admin/inventory/nodes"
tags: ["admin-inventory"]
---

# Update Nodes

`PATCH /api/admin/inventory/nodes`

Apply the same partial update to every node in `nodeIds`.

## Request body

- BulkNodeUpdateRequest — Apply the same partial `values` to every node in `node_ids`.
  - `nodeIds` string[], required
  - `values` NodeMutationRequest, required
    - `name` string, nullable
    - `role` 'GPU_NODE' | 'CPU_NODE'
    - `status` 'ACTIVE' | 'PLANNED' | 'DECOMMISSIONING' | 'OFFLINE' | 'FAILED'
    - `gpuType` string, nullable
    - `gpuCount` integer, nullable
    - `publicIp` string, nullable
    - `publicIpv6` string, nullable
    - `privateIp` string, nullable
    - `privateInterface` string, nullable
    - `sshUser` string, nullable
    - `sshPort` integer, nullable
    - `serial` string, nullable
    - `assetTag` string, nullable
    - `description` string, nullable
    - `comments` string, nullable
    - `tags` string[], nullable
    - `nodeTypeId` string, nullable
    - `siteId` string, nullable
    - `storage` object, nullable
    - `configContext` object, nullable
    - `additional` object, nullable

## Response `200`

Successful Response

- GenericResponseMutationResult
  - `data` MutationResult
    - `operationId` string, required
    - `targetId` string, nullable
    - `targetName` string, nullable
    - `message` string, required
    - `created` integer, nullable
    - `updated` integer, nullable
    - `assigned` integer, nullable
    - `detached` integer, nullable
    - `retired` integer, nullable
  - `status` string, nullable — Response status

## Other responses

- `401` — Authorization failed
- `403` — Insufficient permissions
- `422` — Invalid request data

## Changes

- **2026-09-04** `cf5a8be325a9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/primeintellect/apis/pi-api/changes/api/admin/inventory/nodes/patch.md)

---

[API](https://skmtc.dev/primeintellect/apis/pi-api.md) · [All operations](https://skmtc.dev/primeintellect/apis/pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/primeintellect/pi-api/revisions/cf5a8be325a9/schema)