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 200 then 404.

Request

Responses

200

Account deleted.

401

Missing / invalid / expired / revoked token.

403

Token lacks the finance.accounts.write scope.

404

Account not found within the tenant.

422

The account is in use (reason: in_use).

429

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.

500

Unhandled server error.