# 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.1.2/cli-reference#clireference-operations) that can be managed via CLI using the [resource management commands.](https://docs.akamas.io/akamas-docs/3.1.2/akamas-reference/cli-reference/cli-reference-2) See also this page devoted to commands on [how to define users and workspaces](https://docs.akamas.io/akamas-docs/3.1.2/akamas-reference/cli-reference/user-and-workspace-management-commands).

## 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://2641073690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4ubiK4vpNilxkD7Fauar%2Fuploads%2FjaahNUwnohx5W5qaZTmS%2FScreenshot%202022-12-22%20at%2010.29.29.png?alt=media&#x26;token=866abf9a-2887-48bf-affe-07eece36ffda" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akamas.io/akamas-docs/3.1.2/akamas-reference/glossary/workspaces.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.