Instances

Deploy, inspect, power, destroy and configure customer VMs.

📄️List instances

Returns every live (non-destroyed) instance owned by the calling key.

📄️Deploy an instance

Queues a new instance for deployment and returns immediately with its UUID. Deploy either from an OS image (`os`) or by restoring a snapshot (`snapshot_uuid`). For password auth on an OS deploy the generated root password is returned exactly once in the response; it is empty for SSH-key and snapshot deploys. Poll `GET /instances/{uuid}` to watch it provision.

📄️Get an instance

Returns a single instance, including its month-to-date `cost`. Returns 404 if the instance does not exist or is not owned by the calling key.

📄️Destroy an instance

Queues the instance for destruction and returns immediately. This is irreversible.

📄️Change instance power state

Queues a power action for the instance and returns immediately. A `reboot` keeps the guest's desired state 'on'.

📄️Get reverse DNS

Returns the current PTR record for each address family, or null for a family with no primary IP. Requires the `instance:read` scope (rDNS lives under the instance resource).

📄️Set reverse DNS

Sets the PTR record for one address family. The `answer` is sanitized server-side to a hostname-safe alphabet; the response echoes the value actually stored.