Delete Org
DELETE/api/v1/orgs/:name
Delete an organisation (admin only), and the ingest credentials it owns.
Every hunt naming the org loses its stored tenant ids first and keeps the name,
so it fails as unknown_customers and holds its watermark until it is edited,
rather than reading the rows the org left behind. A production+team posture
routes that hunt change to review, and the X-DFE-Review-Required header says so.
The reserved default org cannot be deleted, nor can an org another org's
ingest credential binds or a fetched source names: each answers 409.
Request
Responses
- 204
- 401
- 403
- 422
- default
Successful Response
No valid session: the credentials are missing, invalid or expired, or the account behind them is disabled or blocked
Refused: the session lacks the action this route checks, or its account must replace an issued password first. A SCIM route answers a refused action in the RFC 7644 error envelope
Validation Error
Problem details (RFC 9457)