---
title: "Machine power control"
method: PATCH
path: "/v2/org/{org}/nico/machine/{machineId}/power"
tags: ["Machine"]
---

# Machine power control

`PATCH /v2/org/{org}/nico/machine/{machineId}/power`

Execute power control actions for a specific Machine. When an Instance is
attached to the Machine, `acknowledgeAttachedInstance` must be `true`.

Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with `PROVIDER_ADMIN` suffix.

## Request body

- MachinePowerControlRequest — Request to power control a Machine
  - `action` 'On' | 'GracefulShutdown' | 'ForceOff' | 'GracefulRestart' | 'ForceRestart' | 'ACPowercycle', required — Redfish power control action to apply to the Machine. ACPowercycle is not supported on Viking systems.
  - `acknowledgeAttachedInstance` boolean — Acknowledges that an Instance is currently attached to the Machine and this action may disrupt Tenant workload on the Instance.

## Response `202`

Machine power control request was accepted. The message is empty unless Core returns a power-manager warning.

- MessageResponse — Structured response with a human-readable message
  - `message` string, required — Human-readable outcome of the request

## 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
- `404` — Error response when requested object is not found
- `500` — Response when the API handler encounters an unexpected error

## Changes

- **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-30** `dabb7c381001` — 1 info
  - endpoint added

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