---
title: "Bring up Racks"
method: POST
path: "/v2/org/{org}/nico/rack/bringup"
tags: ["Rack"]
---

# Bring up Racks

`POST /v2/org/{org}/nico/rack/bringup`

Bring up Racks with optional name filter. If no filter is specified, targets all racks in the Site.

Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix.

## Request body

- BatchBringUpRackRequest — Request body for batch rack bring up operations
  - `siteId` string, uuid, required — ID of the Site
  - `filter` RackFilter — Filter criteria for selecting racks in batch operations. If omitted or empty, all racks in the site are targeted.
    - `names` string[] — Filter racks by name
  - `description` string — Optional description for the bring up operation
  - `ruleId` string, uuid — Optional Operation Rule UUID. When set, pins every bring-up task spawned by this batch to the named rule and overrides Flow's default rule resolution.
  - `overrideReadinessCheck` boolean — When true, proceed even if one or more target components (or hosts on the owning rack) are reported as not ready by their persisted status. Intended for operator-supervised maintenance.

## Response `200`

OK

- BringUpRackResponse — Response for bring up operations containing task IDs for tracking
  - `taskIds` string[] — List of task IDs created for the bring up operation (one per rack)

## 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
- `504` — The Site did not return a result within the request budget allocated to Site communication within the request cycle. This can occur if the Site Controller is down or under heavy request load. Operations are in general safe to retry. In rare cases, operations that create or update resources may succeed even if timeout is returned.

## Changes

- **2026-08-14** `441cfc1afc1c` — 1 info
  - added the non-success response with the status `504`
- **2026-06-12** `268117a96421` — 1 info
  - added the new optional request property `overrideReadinessCheck`
- **2026-06-10** `9a135fa35aad` — 1 info
  - added the new optional request property `ruleId`

[Change history](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/changes/v2/org/:org/nico/rack/bringup/post.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)
