remove_wallet
Permanently remove a wallet from the authenticated user's account. Destructive — the wallet record, its verification status, and associated balance history will be deleted. Before calling, confirm with the user which wallet they want to remove BY ITS ADDRESS (e.g. "remove the Bitcoin wallet at bc1q...abc?") and get explicit confirmation. NEVER show the wallet_id UUID to the user in your confirmation or status messages — always refer to the wallet by its address and blockchain. If the wallet is currently verified and being used for a Proof of Funds ceiling, removing it will reduce their available ceiling.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wallet_id | Yes | Internal wallet UUID from get_wallet_summary. Do NOT show this ID to the user or ask them for it — look it up from the address they mentioned. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | removed | not_found | |
| message | No | ||
| wallet_id | No |