Skip to main content
Archiving is a soft delete. An archived resource keeps all of its data and history, disappears from the normal lists, and can be restored at any time. Instances and projects can be archived. Accounts — users, service accounts, and workload identities — use the same soft delete under a different name: they are deactivated. There is no separate archive dashboard. In both cases you find the hidden resources on the page you archived or deactivated them from, by changing that page’s filter.

​
Instances

To archive an instance, go to Instances, open the row action menu, and click Archive. If databases on the instance are still assigned to projects, select Force to archive to unassign them. An archived instance and its databases stop appearing in instance lists, database lists, and the SQL Editor. To find archived instances, go to Instances, click the search box, choose the State scope, and select Archived. Select All to list active and archived instances together. The list defaults to Active. To restore, open the row action menu and click Restore.
The Archived and All options appear only if you hold the bb.instances.undelete permission, which is granted to Workspace Admin and Workspace DBA.
Archive and restore are also available on the instance detail page.

​
Projects

To archive a project, go to Projects, open the row action menu, and click Archive. You can also archive from the project’s Settings > General > Danger Zone. To find archived projects, use the State scope on Projects the same way as for instances, then click Restore. Restoring is also available from the archived project’s Settings > General > Danger Zone.
The Archived and All options require the bb.projects.undelete permission, granted to Workspace Admin and Workspace DBA.

​
Users, service accounts, and workload identities

Each account type has its own page: IAM & Admin > Users, Service Accounts, and Workload Identities. To deactivate an account, open its row action menu and click Deactivate. To find deactivated accounts, turn on Show inactive accounts at the bottom of the page, then click Restore on the account you want back.

​
Permanent deletion

Archiving is reversible; permanent deletion is not. Workspace Admin and Workspace DBA can permanently delete an instance or a project from the same Delete action, whether or not it has been archived first. Deleting a still-active resource archives it first, then removes it.
  • Deleting an instance asks you to type the instance ID to confirm, and drops its databases along with it.
  • Deleting a project moves its databases to the default project. The default project itself cannot be archived or deleted.
Environments have no archive state — deleting an environment removes it immediately.