Correct a bank account and its opening balance
update_bank_accountCorrect a bank account's details or set its opening balance and date to align the ledger with an audited balance.
Instructions
Correct a bank account's name, institution, BSB, account number, account holder, status, notes, or its opening balance. opening_balance (AUD) is the balance at the START of opening_balance_date: cash transactions dated before that day are excluded from the ledger (the result reports how many, as pre_opening_transaction_count/_total, so they can be reviewed), and the account contributes 0 to any balance as at an earlier date. Use it to anchor the ledger to an audited closing balance — e.g. a 30/6/24 audited balance of $163.93 is opening_balance 163.93 with opening_balance_date 2024-07-01. Refused if the change would move the closing balance of a closed or lodged financial year (reopen that year first). Only the fields you pass change.
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": {
"fund_id": "<fund_id>",
"bank_account_id": "<bank_account_id>"
},
"name": "update_bank_account"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bsb | No | BSB, e.g. "082-001" | |
| name | No | ||
| notes | No | ||
| status | No | ||
| fund_id | Yes | Fund ID (discover via whoami or list_funds) | |
| closed_on | No | Last day the account was open. Closes it (status becomes closed); the ledger can't hold movements after it. Later years drop the account; the year it closed in proves a nil 30 June balance. Reopen by setting status active. as an ISO date, e.g. "2026-05-30" | |
| reasoning | No | Why you are making this change — recorded on the audit log entry for this write | |
| account_role | No | ||
| external_ref | No | Your stable ID for this write (e.g. a statement line or document reference). Repeating a call with the same external_ref replays the first result instead of writing twice. | |
| account_number | No | Account number (stored encrypted) | |
| bank_account_id | Yes | Bank account ID (find via list_bank_accounts) | |
| opening_balance | No | Balance in AUD at the start of opening_balance_date | |
| institution_name | No | ||
| account_holder_name | No | ||
| opening_balance_date | No | Date the opening balance applies from as an ISO date, e.g. "2026-05-30" |