Allocation6

Audit2

BMC Credential1

BMC Reset1

Credential Rotation2

DPU Extension Service7

DPU Machine2

DPU Reprovision1

Expected Machine7

Expected Power Shelf5

Expected Rack7

Expected Switch5

Health Report3

Host Firmware Config2

InfiniBand Partition6

Infrastructure Provider2

Instance10

Instance Type8

IP Block6

iPXE Template2

Machine12

Machine Validation3

Measured Boot Trusted Machine3

Measured Boot Trusted Profile3

Metadata1

Network Security Group5

NVLink Domain4

NVLink Logical Partition6

Operating System5

Rack11

Rule5

Service Account1

Site6

Site Explorer2

SKU5

SSH Key5

SSH Key Group5

Subnet5

Task3

Task Run8

Tenant3

Tenant Account5

Tenant Identity9

Tray9

UEFI Credential1

User1

VPC6

VPC Peering4

VPC Prefix5

Tray

Validate Trays

Validate Tray components by comparing expected vs actual state.

If no filter is specified, validates all trays in the Site. Use rackId/rackName to scope to a specific rack, and name/manufacturer/type to filter by tray attributes.

Compares the expected component configuration against the actual state. Returns a detailed diff report showing missing, extra, and mismatched components.

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

get/v2/org/{org}/nico/tray/validation

Query parameters

siteIdstring uuid required

ID of the Site

rackIdstring uuid

Scope to a specific Rack by ID (mutually exclusive with rackName)

rackNamestring

Scope to a specific Rack by name (mutually exclusive with rackId)

namestring

Filter trays by name

manufacturerstring

Filter trays by manufacturer

type'Compute' | 'NVSwitch' | 'PowerShelf'

Filter trays by type

componentIdstring

Filter by external component ID (requires type; mutually exclusive with rackId/rackName; use repeated params for multiple values)

slotIdinteger

Restrict validation to trays at this rack slot (matches position.slotId). Requires rackId or rackName. Composes with the rest of the filter via AND.

Response

totalDiffsinteger

Total number of component differences found

missingCountinteger

Number of components expected but missing from the source system

unexpectedCountinteger

Number of components found in the source system but not expected

mismatchCountinteger

Number of components present in both but with field differences

matchCountinteger

Number of components that match between expected and actual

Changes

Changed in 6 of the 90 revisions of this API.3716

Aug 20, 2026652b7687aa8133See the full diff
- ▲
  removed the enum value compute from the query request parameter type
  request-parameter-enum-value-removed
- ▲
  removed the enum value powershelf from the query request parameter type
  request-parameter-enum-value-removed
- ▲
  removed the enum value switch from the query request parameter type
  request-parameter-enum-value-removed
- ○
  added the new enum value Compute to the query request parameter type
  request-parameter-enum-value-added
- ○
  added the new enum value NVSwitch to the query request parameter type
  request-parameter-enum-value-added
- ○
  added the new enum value PowerShelf to the query request parameter type
  request-parameter-enum-value-added
Aug 14, 2026441cfc1afc1c1See the full diff
- ○
  added the non-success response with the status 504
  response-non-success-status-added
Jun 12, 2026268117a964214See the full diff
- ○
  added the optional property diffs/items/actual/leakStatus to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property diffs/items/actual/operationStatus to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property diffs/items/expected/leakStatus to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property diffs/items/expected/operationStatus to the response with the 200 status
  response-optional-property-added
Jun 2, 2026b078e63260c123See the full diff
- ●
  removed the optional property driftCount from the response with the 200 status
  response-optional-property-removed
- ●
  added the new Mismatch enum value to the diffs/items/type response property for the response status 200
  response-property-enum-value-added
- ○
  added the new optional query request parameter slotId
  new-optional-request-parameter
- ○
  added the optional property mismatchCount to the response with the 200 status
  response-optional-property-added
- ○
  removed the Drift enum value from the diffs/items/type response property for the response status 200
  response-property-enum-value-removed
Jun 2, 2026ffa06352305832See the full diff
- ●
  deleted the query request parameter slotId
  request-parameter-removed
- ●
  removed the optional property mismatchCount from the response with the 200 status
  response-optional-property-removed
- ●
  added the new Drift enum value to the diffs/items/type response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property driftCount to the response with the 200 status
  response-optional-property-added
- ○
  removed the Mismatch enum value from the diffs/items/type response property for the response status 200
  response-property-enum-value-removed
This revision also has 14 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 2, 2026f20872e0979a23See the full diff
- ●
  removed the optional property driftCount from the response with the 200 status
  response-optional-property-removed
- ●
  added the new Mismatch enum value to the diffs/items/type response property for the response status 200
  response-property-enum-value-added
- ○
  added the new optional query request parameter slotId
  new-optional-request-parameter
- ○
  added the optional property mismatchCount to the response with the 200 status
  response-optional-property-added
- ○
  removed the Drift enum value from the diffs/items/type response property for the response status 200
  response-property-enum-value-removed

Full history