Delete a company
DELETE/companies/:id
Hard-deletes a company. Requires scope finance.companies.write. Blocked with 409 (details carries the per-table counts { transactions, payables, receivables, people }) when the company still has financial records or active people — remove or reassign those first, or soft-deactivate via PATCH { active: false }. Config tables (categories, classification centers, financial accounts, soft-deleted people) cascade automatically. Calling DELETE twice returns 204 then 404.
Request
Responses
- 204
- 401
- 403
- 404
- 409
- 500
Company deleted. No response body.
Missing / invalid / expired / revoked token.
Token lacks the finance.companies.write scope.
Company not found within the tenant.
The company has financial records or active people (details carries the counts).
Unhandled server error.