delete_wireguard_peer
Permanently delete a WireGuard peer from pfSense by its peer ID. Use it to remove unused or compromised VPN peers, with dry-run preview and confirmation safeguards against accidental deletion.
Instructions
Delete a WireGuard peer by ID. WARNING: This is irreversible.
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": {
"peer_id": "<peer_id>"
},
"name": "delete_wireguard_peer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | Must be set to True to execute. Safety gate for destructive operations. | |
| dry_run | No | If True, preview the operation without executing. | |
| peer_id | Yes | Peer ID (from search_wireguard_peers) | |
| apply_immediately | No | Whether to apply changes immediately |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||