Destroy a machine
destroy_vmDESTROYS the machine and its disk, with no undo and no backup kept. With when=now on a monthly or yearly machine: the unused paid time, less the hours used at the hourly rate, returns as account credit; the share paid with gifted credit returns as gifted credit. If the plan changed during the period or the expiry was changed by hand, support works out the amount. Ask the user first. confirm_hostname must be the machine's exact hostname. Scope: vms.destroy.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"vm": "<vm>",
"confirm_hostname": "<confirm_hostname>"
},
"name": "destroy_vm"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vm | Yes | Machine id, as returned by list_vms or create_vm. | |
| when | No | Monthly and yearly machines only: at the end of the paid period (nothing returned), or now (the unused paid time, less the hours used at the hourly rate, returns as account credit; gifted credit returns as gifted; support works out the amount if the plan changed during the period or the expiry was changed by hand). | |
| confirm_hostname | Yes | The machine's exact hostname, typed back as confirmation. |