Skip to main content
DELETE
/
api
/
v1
/
vms
/
{id}
Delete VM
curl --request DELETE \
  --url https://api.raffcomputing.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"
}

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

​
id
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"