Virtual Machines
Delete VM
Permanently delete a virtual machine and release its resources.
Attached Volumes
Control what happens to volumes attached to the VM with volume_action:
- detach (default) — volumes are detached and kept. They remain billable and can be re-attached to another VM.
- delete — volumes are permanently deleted along with the VM.
VPC Cleanup
Set delete_vpc to true to also delete the VM's associated VPC. The VPC is only deleted if no other VMs are using it.
Billing
If the VM has an active subscription, the remaining prepaid balance is refunded pro-rata (hourly precision) to your account balance.
delete/api/v1/vms/{id}
Path parameters
idstring uuid required
VM ID (UUID)
Headers
X-Project-IDstring uuid required
Project ID. Required for all mutating operations (create, delete, power actions, resize).
Request body
Response
VM deleted successfully
Example response
{
"success": true,
"message": "Operation completed successfully"
}