Delete Child
Permanently delete a child organisation and all its associated data.
This is a destructive, irreversible operation. It deletes the child organisation row and cascades to all dependent data including members, API keys, ingestion tasks, locations, metrics, notifications, and webhooks.
โถConfirmation required
You must include the x-confirm-delete: true header. Requests without this header receive a 400 Bad Request response.
โถConstraints
- Returns
409 Conflictif the child has resources that block deletion (e.g. submissions withON DELETE NO ACTIONconstraints). - Returns
404 Not Foundif the child does not exist or is not owned by the caller.
โถUse Cases
- Decommission a test or temporary sub-organisation.
- Clean up a sub-organisation that is no longer needed.
Required scope:
organizations:write