How to delete a workspace and its data

  • Updated

Learn how to delete a Terra workspace and its data, what's removed when you do, and what you're responsible for as a workspace owner.

Your responsibilities as a workspace owner

Terra gives you the tools to share, manage, and delete your workspaces, but workspace owners are responsible for their own workspaces and the data in them. That includes:

  • Controlling who has access to the workspace, and removing people when they no longer need it
  • Making sure data is stored and shared in line with your data use agreements and institutional policies
  • Deleting workspaces, data, and cloud resources when your project ends

Terra Support can't make these changes for youTerra Support can't add or remove workspace members, or delete workspaces or data, on your behalf. To manage access, see Sharing data and tools with workspace access controls and Best practices for sharing and protecting data resources.

Before you delete

Deleting a workspace can't be undoneDeleting a workspace permanently removes its storage bucket, data tables, and cloud resources, and Terra Support doesn't restore deleted workspaces or their data. Copy anything you want to keep before you start.

How to delete a workspace: Step-by-step instructions

1. Go to the Workspaces page from the main navigation at the top left of any page in Terra (Main navigation menu with three parallel lines > Workspaces), or navigate directly to the workspace.

2. Click the three-dot menu on the right side of the page.

3. Select Delete.

4. Confirm the deletion by typing "Delete Workspace".

What to expect

The workspace will no longer appear on your Workspaces page, and collaborators will lose access to it.

Deleting several workspaces at once?If you're closing out a project, filter the Workspaces page by Billing project to see every workspace it funds. To remove the Billing project too, see How to delete a Terra Billing project.

What gets deleted

Resource

What happens when you delete the workspace

Workspace storage (Google bucket)

The bucket and every file in it are deleted. If soft delete is turned on (the default), the bucket and its files are kept for the workspace's soft delete retention period (7 days by default) and then permanently deleted. They can't be purged before the retention period ends. If soft delete was turned off, the bucket may be deleted immediately. See Soft delete for Terra workspace buckets and Google's documentation on projects and Cloud Storage. 

Terra Support doesn't restore deleted workspace data, even if soft delete was applied to the bucket.

Workspace Google project The Google project behind the workspace is deleted. The Terra Billing project that funded it isn't affected.
Cloud Environment VMs and persistent disks All workspace users' Cloud Environment VMs and persistent disks in the workspace are deleted with the Google project. Data on a deleted persistent disk can't be recovered.
Data tables and workspace metadata All data tables and workspace metadata are deleted and can't be recovered.
Logs Workflow task logs and Cloud Environment logs are stored in Google Cloud Logging in the workspace’s Google project and are deleted along with the project. See Understanding the full cost of running workflows in Terra. 

After the retention periods above, Google Cloud permanently deletes the data from its systems, including backups, within about 180 days. Cloud Storage data is also cryptographically erased. See Google's Data deletion on Google Cloud.

What isn't deleted

Deleting a workspace only removes data stored in that workspace. It doesn't affect copies stored anywhere else, including:

  • Files downloaded to a local machine
  • Files copied to external buckets or other workspaces
  • Clones of the workspace
  • Data in external buckets that the workspace's data tables point to

You're responsible for deleting copiesIf you or your collaborators copied data out of the workspace, those copies need to be deleted separately.

Troubleshooting

Click the sections below to expand for more detail. 

  • Only workspace owners can delete a workspace. If you have reader or writer access, ask an owner to delete it or to give you owner permission. You can see who owns a workspace in the Share dialog.
  • The workspace still has a Cloud Environment or app running. Go to the Cloud Environments page, delete the environments and apps for that workspace, and then try again. See Cloud Environment FAQs for help.
  • No. Terra Support doesn't restore deleted workspaces or the data in them. Before you delete a workspace, copy anything you want to keep (see Before you delete).

Additional resources

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.