API reference

Run long operations as observable jobs

Create backups, restore deliberately and track conversion or libvirt migration without holding one HTTP request open.

Asynchronous jobs

Job endpoints report progress and final result and allow cancellation where the underlying operation can stop safely. Persist the job ID and do not infer success from request acceptance.

Backup inventory and plans

/v1/backups and machine backup routes list restore points, start a backup and manage the machine backup plan. Keep backup storage and credentials outside the failure domain of the source host.

Restore

Restore is an explicit mutation. Confirm destination, machine identity, current state and recovery point before approval; validate the recovered guest afterward.

Conversion and libvirt

Conversion and to-libvirt routes produce trackable jobs. Provider ownership changes only after a completed operation and validation—not when a job is merely queued.