What are Workspaces and how do you use them?

Purpose: This document provides a high-level understanding of what role workspaces play in Verily Workbench and links to more detailed documentation covering workspace operations as well as sharing and access controls.

What are workspaces and what capabilities do they provide?

Workspaces are where researchers and teams connect and organize all the elements of their research. This includes data, code, analysis, documentation, and collaboration with others. Workspaces are also a way for data & tool providers to deliver data and tools to researchers, along with helpful resources such as documentation, code, and examples.

Web user interface vs. command-line interface

The Verily Workbench web user interface provides point-and-click access to workspace contents and operations. It presents workspace contents and related actions through three separate panes, named Overview, Resources and Environments.

The Overview pane contains an editable description of the workspace, as well as a set of boxes summarizing useful information and links.

The Resources and Environments panes provide access to data resources and computational environments, respectively, with which you can perform analysis work in Workbench.

  • For more information about Resources, see the Data Resources documentation.
  • For more information about Environments, see the Cloud Environments documentation.

You can also control and manage workspaces and their contents from the Workbench command-line interface (CLI). Any operations you perform using the CLI will be reflected in the web UI, and vice versa.

To learn more about performing workspace operations through the Workbench CLI, see the Command Line Interface documentation.

Workspace operations

You can perform the following operations on workspaces from within the web UI:

  • List your workspaces
  • Create a new workspace
  • Edit a workspace’s description
  • Share a workspace
  • Duplicate (clone) a workspace
  • Delete a workspace

For complete instructions on how to perform these operations through the web UI, see the Workspace Operations page.

For equivalent CLI instructions, see the Command Line Interface documentation.

Access control and sharing options

Workspaces in Workbench are designed to facilitate secure collaboration. When you share a workspace with a collaborator, you can choose what level of access to grant them (Owner, Writer or Reader), which corresponds to a specific set of privileges.

In addition, there are certain important considerations around access to workspace resources that come into play when you or your collaborators share or duplicate workspaces.

To learn more about these topics, please see the Access Control and Sharing page.

Detailed documentation

Access control and sharing

Considerations around sharing workspaces with collaborators and managing access to resources.

Workspace operations (web UI)

Operations that can be applied to workspaces through the web UI.

Last Modified: 16 November 2023