# 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


---

# 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://oten.gitbook.io/identity-support/user-guide/business-account/business-owner-default-authority/organizational-structure/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.
