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 200 then 404.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 429
- 500
Company deleted.
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).
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.