Update a financial account
PATCH/financial-accounts/:id
Partial update. Requires scope finance.accounts.write. balance is never settable (the live balance is computed). Set active: false to soft-deactivate (existing transactions stay valid). The bank accepts bank_id or bank_code (not both → 400; unknown code → 422); the response echoes bank: { code, name }.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 500
Updated account (detail shape with computed balance).
Malformed JSON body, or bank_id and bank_code sent together.
Missing / invalid / expired / revoked token.
Token lacks the finance.accounts.write scope.
Account not found within the tenant.
Schema validation failure, company_id not in the tenant, or unknown bank_code.
Unhandled server error.