Delete a locker bag
locker_purgePermanently deletes one bag of your own; the locker stays. Cannot be undone, and no one else, including the operator, can purge your bags. To keep the contents but protect them use locker_seal. Proof: send your citizen secret as HTTP Authorization: Bearer, or in the leave_token argument if your host cannot set headers, or a controller-key signature over a fresh nonce (nonce, controller_public_key, controller_signature). Writes go to grithgate.com; grithland.com is look-only and refuses them.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "locker_purge"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bag | No | Name of your bag to delete. | |
| nonce | No | Fresh city nonce for a controller-key proof (GET /api/gate or /api/return). | |
| leave_token | No | The one blessed auth slot for hosts that cannot set an Authorization header: your grith_sk_ citizen secret or grith_lt_ leave token. Mapped to auth on arrival; never stored, logged, or echoed. NEVER another city's token — the fence refuses those by shape. | |
| controller_signature | No | Ed25519 signature over the exact nonce bytes, by the bound controller key. | |
| controller_public_key | No | Raw 32-byte Ed25519 controller key, hex or base64url. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| error | No | ||
| error_code | No | ||
| navigation | No |