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 Conflict if the child has resources that block deletion (e.g. submissions with ON DELETE NO ACTION constraints).
  • Returns 404 Not Found if 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