---
title: "Create Or Update BMC Credential"
method: PUT
path: "/v2/org/{org}/nico/credential/bmc"
tags: ["BMC Credential"]
---

# Create Or Update BMC Credential

`PUT /v2/org/{org}/nico/credential/bmc`

Create or update a site-wide or per-BMC root credential. Equivalent
to `nico-admin-cli credential add-bmc`.

User must have authorization role with `PROVIDER_ADMIN` suffix.

## Request body

- BMCCredentialRequest — Request to create or update a BMC credential.
  - `siteId` string, uuid, required — ID of the Site where the credential is stored.
  - `kind` 'SiteWideRoot' | 'BMCRoot', required — Which BMC credential to store.
  - `password` string, required — Credential password.
  - `username` string — Optional username; Core defaults to "root" for BMCRoot when omitted.
  - `macAddress` string — BMC MAC address. Required for kind BMCRoot, ignored for SiteWideRoot.

## Response `200`

BMC credential was created or updated

- BMCCredential — BMC credential metadata returned after create or update. Password is never returned.
  - `siteId` string, uuid, required — ID of the Site where the credential is stored.
  - `kind` 'SiteWideRoot' | 'BMCRoot', required — Which BMC credential was stored.
  - `username` string — Optional username; Core defaults to "root" for BMCRoot when omitted.
  - `macAddress` string — BMC MAC address. Required for kind BMCRoot, ignored for SiteWideRoot.

## 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-07-30** `edcf92c1de65` — 1 breaking, 2 info
  - removed the success response with the status `202`
  - added the non-success response with the status `400`
  - added the success response with the status `200`
- **2026-07-01** `6c8dcd576e4b` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `202`
- **2026-06-24** `90356f383b7c` — 2 breaking, 2 warning, 4 info
  - removed the enum value `bmc-root` of the request property `kind`
  - removed the enum value `site-wide-root` of the request property `kind`
  - added the new `BMCRoot` enum value to the `kind` response property for the response status `200`
  - added the new `SiteWideRoot` enum value to the `kind` response property for the response status `200`
  - …4 more
- **2026-06-22** `1a990cce2ce1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/credential/bmc/put.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/e871abfd58d5/schema)