Delete a financial account
DELETE/financial-accounts/:id
Deletes an account. Requires scope finance.accounts.write. Returns 422 (reason: in_use, with a usage breakdown) when the account has any transaction, payable or receivable — deleting would cascade-delete its transactions, so soft-deactivate via PATCH { active: false } instead. Calling DELETE twice returns 204 then 404.
Request
Responses
- 204
- 401
- 403
- 404
- 422
- 500
Account deleted. No response body.
Missing / invalid / expired / revoked token.
Token lacks the finance.accounts.write scope.
Account not found within the tenant.
The account is in use (reason: in_use).
Unhandled server error.