Skip to navigation

November 3, 2026

Public API 0.8.0: manual backups and asynchronous backup deletion

Start a backup immediately with POST /compute/cloud-vms/{vm_id}/backups/runs or POST /compute/gpu-vms/{vm_id}/backups/runs. An enabled backup policy is required. Send {"requested_by":"api"} to use that policy’s stored billing catalog, or supply an explicit billing_catalog override. The response includes the queued run_id; poll the run until it succeeds or fails. Both operations require vm.write and a workspace_id query parameter.

Deleting a completed backup now returns 202 with status: deleting. The run remains readable while remote cleanup runs, then GET returns 404. A subsequent DELETE also returns 404. Dependency and active-restore conflicts still return 409.


November 3, 2026

Public API 0.9.0: Object Storage and Container Registry paused, one error format, retry keys on networking creates

Object Storage and Container Registry management are temporarily paused. The 25 Object Storage and 26 Container Registry operations answer 404 with an empty body until they resume. That doesn’t mean a resource was deleted. The portal, S3 file traffic, registry pushes and pulls, and your existing resources are not affected. The active reference has 178 operations. The SDKs and CLI keep their methods and commands for the paused operations.

If you use Terraform, provider 0.7.0 and earlier read this 404 as “deleted” and drop buckets, registries and S3 credentials from state. Your data isn’t deleted. Upgrade to 0.8.0 before you run plan or apply; 0.8.0 doesn’t restore state that was already dropped. See Terraform.

One error format. Errors now carry error, message and request_id (also in the X-Request-Id header), alongside any product detail. Internal diagnostics are removed. Gateway refusals can omit message or request_id. See Errors.

Retry keys on networking creates. The six networking creates (VPC, subnet, NAT gateway, port-forwarding rule, Reserved IP and firewall group) accept an optional X-Idempotency-Key. See Idempotency.

Cancel a queued restore. POST /compute/cloud-vm-backups/restores/{restore_id}/actions/cancel and its GPU VM equivalent cancel a restore that hasn’t started. A running restore is refused with 409. Both need vm.write.

GET /compute/plans checks capacity by default. When you pass site_id, the answer now includes availability, available, max_creatable and availability_reason. Set include_availability=false for prices only. The check is advisory: it doesn’t reserve stock, and a create can still lose a capacity race. selectable says only whether a plan has a usable price.

The Python and TypeScript SDKs and the CLI 0.7.0, and Terraform provider 0.8.0, are built from this version.