Wake a VM
POST
Wakes an asleep VM. Poll GET /api/vms/{vmId} until state is running.
apiKeyheader
AuthorizationBearer <hmk_…>An API key from the dashboard or homemade api-key create.
vmId*stringWaking, or already running.
application/json- response
ok*booleanpending?booleanAccepted; the change finishes in the background.
state*stringValue in
"queued""placing""booting""injecting""running""asleep""deep_sleeping""deep_asleep""stopped""failed"curl -X POST 'https://api.homemade.dev/api/vms/string/wake'Example Response
{ "ok": true, "pending": true, "state": "queued"}Update a VM PATCH
Renames the VM, changes its auto-sleep or who can open its services. Every field is optional.
Run a command POST
Runs one command in a running VM as its user, with `/bin/sh -lc`, and answers its exit code and output. It opens no terminal. Use `?stream=1` for commands that run longer than about 90 seconds.