---
title: "Update NVLink Logical Partition"
method: PATCH
path: "/v2/org/{org}/nico/nvlink-logical-partition/{nvLinkLogicalPartitionId}"
tags: ["NVLink Logical Partition"]
---

# Update NVLink Logical Partition

`PATCH /v2/org/{org}/nico/nvlink-logical-partition/{nvLinkLogicalPartitionId}`

Update a specific NVLink Logical Partition

Org must have a Tenant entity. User must have authorization role with `TENANT_ADMIN` suffix.

## Request body

- NVLinkLogicalPartitionUpdateRequest — Request data to update an NVLink Logical Partition
  - `name` string, nullable — Updated name for the NVLink Logical Partition
  - `description` string, nullable — Updated description for the NVLink Logical Partition

## Response `200`

OK

- NVLinkLogicalPartition — NVLink Logical Partitions are logical GPU fabric segments for high bandwidth communication among selective GPUs
  - `id` string, uuid — Unique ID of the NVLink Logical Partition
  - `name` string — Name of the NVLink Logical Partition
  - `description` string, nullable — Optional description of the NVLink Logical Partition
  - `siteId` string, uuid — ID of the Site the NVLink Logical Partition belongs to
  - `tenantId` string, uuid — ID of the Tenant the NVLink Logical Partition belongs to
  - `status` 'Pending' | 'Provisioning' | 'Configuring' | 'Ready' | 'Deleting' | 'Error' — Status values for NVLink Logical Partition objects
  - `statusHistory` StatusDetail[] — Details of status changes for the NVLink Logical Partition over time
    - `status` string — State of the associated entity at a particular time
    - `message` string, nullable — Description of the state and cause/remedy in case of error
    - `created` string, date-time — Date/time when the associated entity assumed the status
    - `updated` string, date-time — Date/time when the associated entity was last observed with this status
  - `nvLinkLogicalPartitionStats` NVLinkLogicalPartitionStats — GPU and Instance counts for an NVLink Logical Partition
    - `totalGpus` integer — Total number of GPUs associated with the NVLink Logical Partition
    - `totalDistinctInstances` integer — Total number of distinct Instances associated with the NVLink Logical Partition
  - `created` string, date-time — Date and time the NVLink Logical Partition was created
  - `updated` string, date-time — Date and time the NVLink Logical Partition was last updated

## Other responses

- `400` — Error response when request data cannot be validated
- `403` — Error response when user is not authorized to call an endpoint or retrieve/modify objects

## Changes

- **2026-06-11** `bc7cf73fe604` — 1 info
  - added the optional property `nvLinkLogicalPartitionStats` to the response with the `200` status

[Change history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/nvlink-logical-partition/:nvLinkLogicalPartitionId/patch.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api.md) · [All operations](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/nvidia-infra-controller-rest-api/revisions/9855f73a9b8e/schema)
