Skip to main content
POST
Reboot or hard reset a Bare Metal host
CLI equivalents: ornn machines reboot <node-id> and ornn machines reset <node-id> --erase-local-data.

Authorizations

Authorization
string
header
required

Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.

Path Parameters

node_id
string<uuid>
required

A Bare Metal host node_id from the reservation's node list. Not a VM id.

Body

application/json

Omit the body for a plain reboot.

mode
enum<string>
default:reboot

reboot keeps data on the host. hard_reset wipes tenant data on the host before rebooting.

Available options:
reboot,
hard_reset
request_id
string | null

Optional client token. A repeated request with the same request_id returns the original request instead of rebooting again.

Response

The reboot or hard reset was queued. This does not mean the host is back.

id
string<uuid>
required

The ID you passed in the path.

node_id
string<uuid>
required

The host node being rebooted.

reservation_id
string<uuid>
required
packet_id
string<uuid>
required

Identifier of the queued request.

mode
enum<string>
required
Available options:
reboot,
hard_reset
reboot
null | object

Reboot progress, or null for a hard reset.