Archiving Environments

Remove environments from your active list without affecting deployed infrastructure

Overview

Archiving moves an environment to the Archived tab, removing it from your active environment list. Archived environments no longer trigger new runs, but all existing infrastructure remains untouched. Archiving is purely a visibility and state change: no resources are created, modified, or destroyed.

You can archive an environment regardless of its install status (live, uninstalled, or draft) and unarchive it at any time to restore full functionality. However, you cannot archive an environment while a run is in progress. Wait for the current run to complete before archiving.

circle-info

Archiving does not destroy infrastructure. If you want to tear down resources, uninstall the environment first. See Runs for details on the uninstall workflow.

How to archive an environment

1

Open the environment actions menu

From the Environmentsarrow-up-right page, go to the environment you want to archive and click the he three-dot menu.

2

Click Archive

Select Archive from the dropdown menu.

3

Confirm

Review the confirmation message and confirm. The environment moves to the Archived tab.

How to unarchive an environment

1

Open the Archived tab

Navigate to the Archivedarrow-up-right tab in the environments list.

2

Click Unarchive

Find the environment you want to restore and click Unarchive. The environment returns to the active list and can trigger runs again.

Other ways to archive environments

  • API: use the POST /api/v1/envs/archive and POST /api/v1/envs/unarchive endpoints. See the Envs API reference.

Last updated

Was this helpful?