POST /api/vms/{id}/reboot

Reboot a VM by stopping and starting it.

Property	Value
Scope	readwrite
Request body	none
Success	204 No Content

Endpoint

POST ${baseUrl}/api/vms/${id}/reboot

readwrite

Stop and start a VM.

Use your host URL and API key as shell variables:

baseUrl="https://agent.example.com"
VIRT_AGENT_API_KEY="<your-api-key>"

cURL template

curl --request POST "${baseUrl}/api/vms/${id}/reboot" \
  --header "Authorization: Bearer ${VIRT_AGENT_API_KEY}"

Request

Location	Name	Type	Required	Description
Header	Authorization	bearer token	yes	Bearer ${VIRT_AGENT_API_KEY} from a readwrite key.
Path	id	string	yes	VM id.

Response

Status	Body	Description
204 No Content	none	Reboot request completed at the host API layer. Read the VM afterward for current state.

Examples

Call example

baseUrl="https://agent.example.com"
VIRT_AGENT_API_KEY="<your-api-key>"
id="demo-api-vm"

curl --request POST "${baseUrl}/api/vms/${id}/reboot" \
  --header "Authorization: Bearer ${VIRT_AGENT_API_KEY}"

Response example

HTTP/1.1 204 No Content

Errors

Status	Code	Description
401	UNAUTHORIZED	API key is missing or invalid.
403	FORBIDDEN	Key is read-only or endpoint is outside the key allowlist.
404	NOT_FOUND	VM id does not exist.
409	INVALID_STATE	VM state does not allow reboot.
500	CH_ERROR, NETWORK_ERROR, STORAGE_ERROR, or INTERNAL	Host failed during stop, cleanup, or boot.