Delete an account
delete_accountChanges- What it does
- Changes or deletes something you had. Your assistant can ask you to confirm first. Safe to retry: the same call twice changes nothing more.
- Permission
- Transactions, change
transactions:write
What your assistant is told
Permanently delete one of the user's accounts. account is its id, alias or IBAN. If transactions are still in it you MUST say what happens to them in transactions: "delete" removes them with the account (cannot be undone), "move" moves them to moveToAccount first (a moved line whose bank external id the target already holds is dropped as a duplicate, and counted in transactionsDeleted). Omitted, a non-empty account is refused and the error says how many transactions it holds — tell the user and ask; never pick "delete" on their behalf. Returns the counts deleted and moved.
Parameters
accounttext, requiredAccount id, alias or IBAN, fromlist_accounts.transactionstext, optionalWhat to do with transactions still in it: "delete" or "move". Omit to refuse if there are any.moveToAccounttext, optionalWith transactions="move": the account (id, alias or IBAN) to move them into.