Destroy handed-off content immediately
handoff_revokeDestroy content stored by handoff_put before its TTL expires using the writer's revoke_key—use when the wrong item was sent or the sender changes their mind.
Instructions
Destroy content stored by handoff_put right now, before its TTL runs out and whether or not it has been fetched. Requires the revoke_key returned by handoff_put — the person fetching with the short code cannot revoke, only the writer can. Use this the moment someone says they sent the wrong thing, or changed their mind. Revoking an already gone item is not an error: the outcome is reported as 'already_gone'.
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": {
"revoke_key": "<revoke_key>"
},
"name": "handoff_revoke"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| revoke_key | Yes | The revoke_key returned by handoff_put. Not the short code — the short code cannot destroy anything. |