> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oasm.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace

> Understand workspaces in OASM - the core organizational unit for multi-tenant architecture

A Workspace is the core organizational unit in OASM, designed to support a **multi-tenant architecture**. It provides an isolated environment where teams or organizations can manage their attack surface independently within a shared platform.

Each workspace acts as a dedicated context that allows users to:

* Manage assets such as domains, subdomains, IPs, and services
* Run and monitor scanning jobs
* Analyze and track vulnerabilities
* Receive real-time security alerts

Workspaces enable multiple users to collaborate within the same environment while ensuring strict data isolation between different workspaces. This guarantees that data, scans, and results from one tenant are completely separated from others.

<Warning>
  You need to join at least one workspace to be able to use it.
</Warning>

## Create new workspace

To create a new workspace:

1. From the dashboard or workspace selector, click the **Create workspace** button
2. Enter a unique workspace name
3. (Optional) Add a description to provide context (e.g., project name, client, or environment like staging/production)
4. Click **Save** to create the workspace

## Update workspace

To update workspace information:

1. Navigate to **Settings → Workspace**
2. Locate the workspace configuration form
3. Update the following fields:
   * **Name**
   * **Description**
4. Click **Save** button to apply changes

Changes are applied immediately and will reflect across the entire workspace.

***

## Delete workspace

Workspace deletion is a sensitive and irreversible operation.

To delete a workspace:

1. Navigate to **Settings → Workspace**
2. Scroll to the **Danger Zone** section
3. Click the **Delete** button
4. Confirm the deletion by following the on-screen instructions

<Danger>
  Deleting a workspace will permanently remove all associated data, including assets, scan results, vulnerabilities, and configurations.\
  This action **cannot be undone**.
</Danger>