How to clean up and reset your Spacelift workspace

If you need to start fresh with your Spacelift workspace after a proof-of-concept phase or want to clean up unwanted resources, you'll need to manually delete resources from within your workspace. Spacelift cannot perform a full reset or clear-out at the tenant/workspace level on your behalf.

Why not delete the entire organization?

While it's technically possible to delete your entire organization from Spacelift, this approach is not recommended for several reasons:

• It involves licensing considerations and waiting periods

• Resources created with Spacelift will not be automatically deleted - they would still need to be deleted manually

• The process can be more complex than expected

Recommended cleanup process

The best practice is to delete resources through stacks first, then proceed with cleaning up other components. This approach helps you avoid leaving orphaned infrastructure in your cloud accounts. The full cleanup process may take up to 2 hours, depending on the size and complexity of your setup.

Follow this deletion order:

1. Cancel Active Runs – Cancel queued/running runs and wait until they complete. You can use the Runs page to bulk-cancel instead of going stack by stack.

2. Disable Drift Detection – Turn off drift detection and cancel any scheduled drift runs.

3. Delete Stacks in Dependency Order – Start with child stacks, then parent stacks. Use "Delete Stack" with the destroy resources option.

4. Delete providers → modules → module versions

5. Delete Contexts and Policies

6. Remove Integrations (if you don't plan on using them anymore)

7. Delete Worker Pools – Drain workers first, delete private worker pools and clean up worker pool configurations

8. Reset User Management – Remove custom roles and role bindings

9. Delete Spaces (child → parent; root space cannot be deleted)

Following this systematic approach will give you a clean slate to build from while ensuring no infrastructure is left orphaned in your cloud accounts.