Skip to main content
DELETE
/
api
/
v1
/
vms
/
bulk
Bulk Delete VMs
curl --request DELETE \
  --url https://api.raffcomputing.com/api/v1/vms/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "volume_action": "delete",
  "delete_vpc": true
}
'
{
  "success": true,
  "message": "<string>",
  "total_count": 123,
  "success_count": 123,
  "failed_count": 123,
  "results": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "success": true,
      "message": "<string>",
      "error": "<string>"
    }
  ]
}

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).

Body

application/json
​
ids
string<uuid>[]
required

VM IDs to delete (1–50).

Required array length: 1 - 50 elements
​
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 associated VPCs. Only succeeds if no other VMs are using them.

Response

Bulk deletion results

​
success
boolean

true if at least one VM was deleted successfully.

​
message
string
​
total_count
integer

Number of VMs requested for deletion.

​
success_count
integer

Number of VMs successfully deleted.

​
failed_count
integer

Number of VMs that failed to delete.

​
results
object[]

Per-VM deletion results.