--- title: "Update Site" method: PATCH path: "/v2/org/{org}/nico/site/{siteId}" tags: ["Site"] --- # Update Site `PATCH /v2/org/{org}/nico/site/{siteId}` Update a specific Site User must have authorization role with `PROVIDER_ADMIN` suffix. Infrastructure Provider updating the Site must be the owner of the Site. At present, there are no other Site-specific configurations modifiable by Tenant. Providers can set `capabilities.dpsPowerManagement` to control whether the Site accepts power profiles and resource groups. Omission or `null` preserves the current value; the default is `false`. ## Request body - SiteUpdateRequest — Request data to update a Site - `name` string, nullable — Update name of the Site. Can only be updated by Provider - `description` string, nullable — Update description for the Site. Can only be updated by Provider - `renewRegistrationToken` boolean — Set to true to issue a new registration token. Can only be updated by Provider - `serialConsoleHostname` string, hostname, nullable — Hostname to reach Serial Console for the Site. Can only be updated by Provider - `isSerialConsoleEnabled` boolean — Enable/disable Serial Console. Can only be updated by Provider. Modifying this attribute has no actual effect on SOL. It will be removed in a future API version. - `serialConsoleIdleTimeout` integer — Maximum idle time in seconds before Serial Console is disconnected. Can only be updated by Provider. Modifying this attribute has no actual effect on SOL. It will be removed in a future API version. - `serialConsoleMaxSessionLength` integer — Maximum length of Serial Console session in seconds. Can only be updated by Provider. Modifying this attribute has no actual effect on SOL. It will be removed in a future API version. - `isSerialConsoleSSHKeysEnabled` boolean — Enable/disable Serial Console access using SSH Keys. Previously updateable only by Tenants, modifying this value is no longer supported, update SSH Key Groups to remove Site instead. - `location` SiteLocation — Location of the Site - `city` string — City where the site is located - `state` string — State where the site is located - `country` string — Country where the site is located - `contact` SiteContact — Contact for the Site - `email` string — Email address of the Site contact - `capabilities` SiteCapabilitiesUpdateRequest — Request to modify Site's capabilities. Partial update allowed, only specify capabilities that should be updated. - `nativeNetworking` boolean, nullable — Enable or disable native networking for the Site - `networkSecurityGroup` boolean, nullable — Enable or disable network security groups for the Site - `nvLinkPartition` boolean, nullable — Enable or disable NVLink partition support for the Site - `flow` boolean, nullable — Enable or disable NICo Flow for the Site - `imageBasedOperatingSystem` boolean, nullable — Enable or disable image-based operating system support for the Site - `dpsPowerManagement` boolean, nullable — Enable or disable DPS power management for the Site. Omission or `null` preserves the current value. Only Providers can update this field. ## Response `200` OK - Site — Site is a datacenter that is running NVIDIA Infra Controller (NICo) services - `id` string, uuid — Unique UUID v4 identifier for the Site in NICo Cloud - `name` string — Name of the Site - `description` string, nullable — Optional description for the Site - `org` string — NGC organization ID of the Infrastructure Provider that owns the Site - `infrastructureProviderId` string, uuid — ID of the Infrastructure Provider that owns the Site - `siteControllerVersion` string, nullable — Version of the Site Controller software - `siteAgentVersion` string, nullable — Version of the Site Agent software - `registrationToken` string, nullable — Token that can be used to register a Site. Value only exposed to Provider - `registrationTokenExpiration` string, date-time, nullable — Date/time when registration token expires. Value only exposed to Provider - `serialConsoleHostname` string, hostname, nullable — Serial console hostname of the site controller - `isSerialConsoleEnabled` boolean — Indicates if Serial Console is enabled for the Site by the Provider - `serialConsoleIdleTimeout` integer, nullable — Maximum idle time in seconds before Serial Console is disconnected - `serialConsoleMaxSessionLength` integer, nullable — Maximum length of Serial Console session in seconds - `isSerialConsoleSSHKeysEnabled` boolean — Only visible to Tenant retrieving the Site. Indicates if Serial Console access using SSH Keys is enabled by Tenant - `isOnline` boolean — Indicates if the Site is currently reachable from Cloud - `status` 'Pending' | 'Registered' | 'Error' — Status values for Site objects - `statusHistory` StatusDetail[] — Chronological status history for the Site - `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 - `created` string, date-time — Date/time when the Site was created - `updated` string, date-time — Date/time when the Site was last updated - `location` SiteLocation — Location of the Site - `city` string — City where the site is located - `state` string — State where the site is located - `country` string — Country where the site is located - `contact` SiteContact — Contact for the Site - `email` string — Email address of the Site contact - `capabilities` SiteCapabilities — Boolean flags to indicate features supported by a Site - `nativeNetworking` boolean — Whether the Site supports native networking - `networkSecurityGroup` boolean — Whether the Site supports Network Security Groups - `nvLinkPartition` boolean — Whether the Site supports NVLink partitioning - `flow` boolean — Whether the Site supports Flow-based operations - `imageBasedOperatingSystem` boolean — Whether the Site supports image-based operating system provisioning - `vpcSlaac` boolean — Whether the latest successfully stored Site configuration inventory reports that Core supports VPCs with SLAAC enabled. False also represents a missing Site configuration or an inventory report that omits the capability. This value is managed by Site configuration inventory and cannot be updated through the Site API. - `dpsPowerManagement` boolean — Whether this Site accepts non-empty power resource groups and power profiles for DPS power management. When false, omission and explicit clearing remain allowed. - `machineStats` SiteMachineStats — Machine stats for a Site - `total` integer — Total number of Machines at the Site - `totalByStatus` SiteMachineStatsByStatus — Machine stats for a Site by status - `Decommissioned` integer — Number of Machines in Decommissioned status - `Decommissioning` integer — Number of Machines in Decommissioning status - `Error` integer — Number of Machines in Error status - `Initializing` integer — Number of Machines in Initializing status - `InUse` integer — Number of Machines in InUse status - `Maintenance` integer — Number of Machines in Maintenance status - `Ready` integer — Number of Machines in Ready status - `Reset` integer — Number of Machines in Reset status - `Unknown` integer — Number of Machines in Unknown status - `totalByHealth` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `totalByStatusAndHealth` SiteMachineStatsByStatusAndHealth — Machine stats for a Site by status and health - `Decommissioned` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `Decommissioning` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `Error` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `Initializing` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `InUse` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `Maintenance` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `Ready` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `Reset` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `Unknown` SiteMachineStatsByHealth — Machine stats for a Site by health - `healthy` integer — Number of healthy Machines - `unhealthy` integer — Number of unhealthy Machines - `totalByAllocation` SiteMachineStatsByAllocation — Machine stats for a Site by allocation - `allocatedInUse` integer — Number of allocated Machines currently in use - `allocatedNotInUse` integer — Number of allocated Machines not currently in use - `unallocated` integer — Number of Machines not currently allocated - `gpuStats` MachineGPUStats[] — GPU counts grouped by GPU type for the Site. Populated when includeGpuStats is set - `name` string — GPU name from the MachineCapability record - `gpus` integer — Total number of GPUs (summation of all Machine GPU capability counts) - `machines` integer — Number of machines that have this GPU capability ## 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-08-24** `9c78a8936b34` — 2 info - added the new optional request property `capabilities/dpsPowerManagement` - added the optional property `capabilities/dpsPowerManagement` to the response with the `200` status - **2026-08-21** `5c6bffda4e24` — 2 info - added the optional property `machineStats/totalByStatus/Decommissioning` to the response with the `200` status - added the optional property `machineStats/totalByStatusAndHealth/Decommissioning` to the response with the `200` status - **2026-08-20** `a482c2d8f5e2` — 1 info - added the optional property `capabilities/vpcSlaac` to the response with the `200` status - **2026-07-10** `3ff50f4d9fbc` — 1 info - added the optional property `gpuStats` to the response with the `200` status - **2026-06-02** `b078e63260c1` — 2 info - added the non-success response with the status `400` - added the non-success response with the status `403` [Full history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/site/:siteId/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/2096eb1db2c1/schema)