RArafftechnologies
Virtual Machines

Bulk Delete VMs

Changed on

Delete up to 50 virtual machines in a single request.

Each VM is processed independently — if some deletions fail, others still succeed. The response includes per-VM results so you can identify and retry failures.

Attached Volumes

Control what happens to volumes attached to the VMs 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 each VM's associated VPC (default false). A VPC is only deleted if no other VMs are using it.

Billing

For VMs with active subscriptions, the remaining prepaid balance is refunded pro-rata (hourly precision) to your account balance.

delete/api/v1/vms/bulk

Request

  • Base URL
    https://api.rafftechnologies.com
  • URL
    https://api.rafftechnologies.com/api/v1/vms/bulk
  • Auth
    API key in header X-API-Key

Headers

X-Project-IDstring uuid required

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

Request body

idsstring[] required

VM IDs to delete (1–50).

volume_action'detach' | 'delete'

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

delete_vpcboolean

Whether to delete associated VPCs. Only succeeds if no other VMs are using them.

Response

Bulk deletion results

successboolean

true if at least one VM was deleted successfully.

messagestring
total_countinteger

Number of VMs requested for deletion.

success_countinteger

Number of VMs successfully deleted.

failed_countinteger

Number of VMs that failed to delete.

Changes