# Workspace

A **workspace** is a virtual environment that groups systems, workflows, and studies to restrict user access to them: a user can access these resources only when granted the required permissions to that workspace.

Akamas defines two user roles according to the assigned permission on the workspace:

* **Contributors** (write permission) can create and manage workspace resources (studies, telemetry instances, systems, and workflows) and can also do exports/imports, view all global resources (Optimization Packs, and Telemetry Providers), and see remaining credits;
* **Viewers** (read permission) can only access optimization results but cannot create or modify workspace resources.

Workspaces and accesses are managed by users with administrative privileges. A user with administrator privileges can manage licenses, users, workspaces, and install/deinstall Optimization Packs, and Telemetry Providers.

Workspaces can be defined according to different criteria, such as:

* By department (e.g. Performance, Development)
* By initiative (e.g. Poc, Training)
* By application (e.g. Registry, Banking..)

A workspace is described by the following property:

* a **name** that uniquely identifies the workspace

## Commands

A workspace is an [Akamas resource](https://docs.akamas.io/akamas-docs/3.6/cli-reference#clireference-operations) that can be managed via CLI using the [resource management commands.](https://docs.akamas.io/akamas-docs/3.6/reference/cli-reference/resource-management) See also this page devoted to commands on [how to define users and workspaces](https://docs.akamas.io/akamas-docs/3.6/reference/cli-reference/user-and-workspace-management).

## User Interface

The workspace a study belongs to is always displayed. Filters can be used to select only studies belonging to specific workspaces

<figure><img src="https://4103111959-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrIhBBVa4sw46ol13SWX%2Fuploads%2Fgit-blob-8883f6473d28a0ff58bfba14114a3fb0e66dda65%2FScreenshot%202022-12-22%20at%2010.29.29.png?alt=media" alt=""><figcaption></figcaption></figure>