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
- 409
- 422
- 429
- 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.
X-Idempotency-Key reused with a different body.
Schema validation failure, company_id not in the tenant, or unknown bank_code.
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.