delete_guest
Delete a stopped Proxmox guest with all disks and snapshots, removing backups unless keep_backups is true; protected backups always remain.
Instructions
Delete a stopped guest with all its disks and snapshots — and its backups, which Proxmox would keep (protected ones always stay), unless keep_backups is true.
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": {
"host": "<host>",
"vmid": "<vmid>",
"reason": "<reason>"
},
"name": "delete_guest"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | The host's id, from list_hosts. | |
| vmid | Yes | The guest's ID (VMID). | |
| reason | Yes | Why you are doing this, in a sentence. The user sees it in the approval window and in the log. | |
| keep_backups | No | Keep its backups. |