Delete VM

curl --request DELETE \
  --url https://api.rafftechnologies.com/api/v1/vms/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "volume_action": "delete",
  "delete_vpc": true
}
'

{
  "success": true,
  "message": "Operation completed successfully"
}

Lifecycle

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

vms

{id}

Delete VM

curl --request DELETE \
  --url https://api.rafftechnologies.com/api/v1/vms/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "volume_action": "delete",
  "delete_vpc": true
}
'

{
  "success": true,
  "message": "Operation completed successfully"
}

_{Updated May 8, 2026}

Authorizations

X-API-Key

string

header

required

API key for authentication. Each key is bound to a specific account.

Headers

X-Project-ID

string<uuid>

required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Path Parameters

string<uuid>

required

VM ID (UUID)

Body

application/json

volume_action

enum<string>

default:delete

What to do with attached volumes. detach keeps them (still billable), delete removes them permanently.

Available options:

detach,

delete

delete_vpc

boolean

default:true

Whether to delete the associated VPC. Only succeeds if no other VMs are using it.

Response

VM deleted successfully

success

boolean

Example:

true

message

string

Example:

"Operation completed successfully"

Last modified on May 8, 2026

Get VM Bulk Delete VMs