Undo a purchase
undo_purchaseUndoes a Deal Desk purchase recorded by mistake (before it is listed or sold): the card comes out of the user's SlabLineage collection and the purchase no longer counts on the Deal Desk scoreboard. Before calling, ask the user "Undo the purchase of for $? It comes out of your collection and the scoreboard." and pass confirm true after they say yes. Pass an idempotencyKey. Undoing a purchase that is already undone answers repeated true and changes nothing. If the result has alerts, show them to the user before anything else.
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": {
"dealId": "<dealId>",
"confirm": "<confirm>"
},
"name": "undo_purchase"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dealId | Yes | The dealId of the purchase (from record_purchase). | |
| confirm | Yes | True once the user said yes to undoing this purchase; never set it before that. | |
| idempotencyKey | No | A unique key for this record (any short text you make up once); a retry with the same key never records twice. |