> For the complete documentation index, see [llms.txt](https://oten.gitbook.io/identity-support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oten.gitbook.io/identity-support/user-guide/organization-admin-app/business-owner-default-authority/organizational-structure/workspaces.md).

# Workspaces

### Scope <a href="#scope" id="scope"></a>

This document explains how **Workspaces** function within the organizational structure and how administrators create and manage them.

***

### I am new. Where should I start? <a href="#i-am-new.-where-should-i-start" id="i-am-new.-where-should-i-start"></a>

#### What is a Workspace? <a href="#what-is-a-workspace" id="what-is-a-workspace"></a>

A **Workspace** is a logical boundary inside an organization used to group:

* Users
* Resources
* Configurations
* Access permissions

Workspaces define **where access is scoped** and **where work happens**.

***

#### How Workspaces fit into the organization <a href="#how-workspaces-fit-into-the-organization" id="how-workspaces-fit-into-the-organization"></a>

At a high level, the structure looks like this:

`Organization ├── Workspace A ├── Workspace B └── Workspace C`

* An organization can have multiple workspaces
* Users can belong to one or more workspaces
* Access is always evaluated in the context of a workspace

***

#### Why Workspaces exist <a href="#why-workspaces-exist" id="why-workspaces-exist"></a>

Workspaces help organizations:

* Separate projects, products, or environments
* Isolate access between teams
* Apply security policies at a smaller scope than the entire organization
* Delegate administration safely

***

#### When should you use Workspaces? <a href="#when-should-you-use-workspaces" id="when-should-you-use-workspaces"></a>

Use Workspaces when:

* You manage multiple projects or teams
* You need to isolate environments (Dev / Staging / Production)
* Different groups require different access rules

Note\
Small organizations may start with a single workspace and expand later.

***

### I already understand. How do I proceed step by step? <a href="#i-already-understand.-how-do-i-proceed-step-by-step" id="i-already-understand.-how-do-i-proceed-step-by-step"></a>

#### Step 1: Open Workspace Management <a href="#step-1-open-workspace-management" id="step-1-open-workspace-management"></a>

* Sign in to the Admin Console
* Navigate to [Oten Workspace](https://workspace.oten.live/more-spaces)
* Select **Workspaces**

***

#### Step 2: Create a New Workspace <a href="#step-2-create-a-new-workspace" id="step-2-create-a-new-workspace"></a>

* Click **Create Workspace**
* Enter a workspace name (required)
* Optionally add a description to clarify its purpose
* Click **Create workspace**

***

#### Step 3: Manage Workspace Profile <a href="#step-3-manage-workspace-profile" id="step-3-manage-workspace-profile"></a>

After the workspace is created, you can manage its basic information from **Workspace profile**:

* Update **Workspace name**
* Update **Description** (optional)
* View **Workspace code** (read-only, used for identification)

Changes are applied immediately and affect all users within the workspace.

***

#### Step 4: Manage Access and Membership <a href="#step-4-manage-access-and-membership" id="step-4-manage-access-and-membership"></a>

From **Access management**, control who can access the workspace:

* Add users → Navigation **Individuals → Add individuals**
* Remove users → Navigation **Individuals**&#x20;
* Organize users into **Groups :** Add group and Management group<br>

**Note** :\
\- View members\
\- Manage roles\
\- Remove Group

* Assign **Roles and permissions** scoped to the workspace : Create Role and Delete role<br>

  &#x20;

Access changes take effect immediately.

***

#### Step 5: Configure Workspace Resources <a href="#step-5-configure-workspace-resources" id="step-5-configure-workspace-resources"></a>

Within the workspace, administrators can manage:

* Applications and integrations
* Subscription and marketplace apps
* Workspace-specific configurations and settings

All resources created here are isolated to this workspace.

***

#### Step 6: Review Activity and Audit Logs <a href="#step-6-review-activity-and-audit-logs" id="step-6-review-activity-and-audit-logs"></a>

Use **Activity log** to:

* Track workspace-level changes
* Monitor administrative actions
* Support auditing and security reviews