Organization Deletion & Full Data Purge
Organization Deletion & Full Data Purge
The org deletion workflow provides a controlled, admin-gated process for permanently offboarding an organization and purging all of its associated data from the platform.
Overview
When an organization no longer needs access to the platform — whether due to contract end, account closure, or data compliance requirements — a platform admin can initiate a full deletion. The workflow is designed to be deliberate and irreversible: a mandatory confirmation step prevents accidental triggers, and the actual deletion is processed via a background job for reliability at scale.
What Gets Deleted
Confirming an org deletion permanently removes all data scoped to that organization:
| Data Type | Details |
|---|---|
| Courses | All course records, modules, and lesson content |
| Enrollments | All learner enrollment records and progress data |
| Assets | Uploaded files, images, documents, and embedded video references |
| User Memberships | All org-scoped user accounts and access roles |
⚠️ This action is irreversible. There is no recovery path once the deletion job has been queued and confirmed. Ensure any required data has been exported before proceeding.
How It Works
1. Initiate Deletion
Navigate to the organization's settings in the admin console and select the Delete Organization action. This is only available to platform-level admins.
2. Confirm the Action
A mandatory confirmation prompt will appear requiring explicit acknowledgement before proceeding. This step cannot be skipped or automated — it must be completed interactively by the admin.
3. Background Job is Queued
Upon confirmation, a background job is enqueued to perform the full data purge. Processing is asynchronous, so the org and its data may remain briefly visible until the job completes. No new activity (logins, enrollments, content edits) will be permitted for the org once deletion is initiated.
4. Purge Completes
Once the background job finishes, all org data is permanently removed from the system. The organization record itself is also deleted.
Access & Permissions
- Only platform admins can initiate an org deletion.
- Org-level admins do not have access to this workflow.
- There is no API endpoint to trigger deletion — the confirmation step requires an interactive admin session.
Use Cases
- Contract offboarding: Remove all org data at the end of a subscription term to comply with data retention policies.
- GDPR / data erasure requests: Fulfil right-to-erasure obligations by purging all personally identifiable data associated with an org's members.
- Test or sandbox cleanup: Permanently remove trial or staging organizations from the platform.