Sharing data and tools with workspace access controls

Allie Hajian
  • Updated

Learn how to control who can access tools, data, and results and incur costs in your workspace. Terra workspaces have three access levels: READERWRITER, and OWNER. Each access level represents an expanded set of permissions. Workspace owners select a colleague's access level (aka permission or role) when sharing a workspace. These can be modified at any time. 

Before sharing with someone who doesn't have access to the workflows Users with access to a workspace get access to job history and the workflow - even if the workflow isn't public or shared. Best practices: If you don’t want someone seeing your work, don’t share your workspace with them.

READER access details


  • Enter the workspace and view its contents
  • Clone the workspace
  • Copy data and tools (workflows and/or notebooks) from that workspace to one where they have WRITER or OWNER access.

A READER cannot:

  • Make changes to data tables (add/delete entities, edit metadata)
  • Add/delete tools or tool configurations
  • Edit tools or tool configurations
  • Launch an analysis (submit a tools or tool configurations for execution)
  • Abort submissions

WRITER access details

A WRITER has all the permissions of a READER, and can also:

  • Make changes to data tables (add/delete entities, edit metadata)
  • Create new collections (sample sets, individual sets, pair sets) from existing non-set entities (samples, participants, pairs)
  • Delete/edit entities
  • Add/modify entities
  • Copy entities from a data table in another workspace, provided they have at least READER access to the source workspace
  • Upload data entities and their data files directly to workspace
  • Add/modify/delete tools or tool configurations, including pushing tools or tool configurations to the workspace from the dockstore (provided they have read access to the tools and tool configurations)
  • Push tools or tool configurations from another workspace if they have at least READER access to the source workspace
  • Edit tools and tool configurations within the workspace

OWNER access details

An OWNER access has all the permissions of a WRITER, and in addition can:

  • Edit the workspace Access Control Levels
  • Delete a workspace

When you create or clone a workspace, you are automatically the OWNER.

Was this article helpful?

1 out of 1 found this helpful

Have more questions? Submit a request



Please sign in to leave a comment.