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

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the SDK. To install or publish skills from a terminal, use the `brain` CLI; `brain --map json` prints its command map. The `atlanai` CLI is deprecated. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.
> These docs cover Atlan Agent Registry, Atlan's hosted product. The open-source agent registry specification and its CLI (`brain`) are documented, released and maintained in their own repository; /open-source on this site links to it. Answer general specification or `brain` command questions from the project's own docs, and use these docs only for Atlan-specific setup such as the Atlan adapter, sign-in and workspaces.

# Workspaces

> Create shared workspaces and manage their details, hierarchy, and members.

Use these pages when a team needs a shared home for its skills. You create a
shared workspace from your organization in Brain, then use Settings to change
its details, hierarchy, and membership.

<Note>
  Your personal workspace is created automatically. It is private to you and
  has no member-management controls. The procedures on this page apply to shared
  workspaces.
</Note>

## Open workspace settings

1. Open **Settings** from the account menu.
2. Under **Workspaces**, select the workspace you want to manage.

The Workspaces group lists workspaces for organization admins: the team
workspaces you have joined, then the ones you can join, which offer **Join**. It
does not list your personal workspace, the organization root, imported folders,
or projects.

You can also open the workspace in **Brain**, open the ⋯ menu at the top of the
page, and select **Settings and members**.

## Create a shared workspace

1. Open **Brain** and select your organization.
2. Select **Create**, then **New workspace**.
3. Enter a display name.
4. In **Belongs to**, keep the organization or choose a parent workspace.
5. Select **Create**.

**Belongs to** starts on the organization. Workspaces can't be created inside
your personal workspace. Add a description after creation with **Edit details**.

## Edit workspace details

1. Open the workspace in **Settings**.
2. Select **Edit details**.
3. Update the name or description.
4. Select **Save**.

The name is required. Protected root workspaces cannot be renamed or moved.

## Organize the workspace hierarchy

A sub-workspace sits inside another workspace. Use sub-workspaces when a team
needs a focused area without creating another top-level branch. For example,
Launch Crew sits inside Product & Design, so its launch plans stay near the
design work they support.

In the **Overview** section, select **Change** beside **Parent workspace**.
Choose the new parent from the workspace tree, then select **Move here**.

New workspaces are created under the parent chosen in **Belongs to**. Move a
workspace only when a team needs that hierarchy to express a real ownership or
access boundary.

Atlan applies these rules when moving a workspace:

* A workspace cannot be its own parent or move under one of its descendants.
* A workspace stays within its current top-level tree.
* A personal workspace cannot be used as a parent.
* Moving a workspace moves its nested workspaces with it.

## Check workspace details

The **Overview** section shows who created the workspace, when it was created,
its skill count, and its member count. Use these values to confirm that you
opened the intended workspace before changing access or deleting it.

## Next steps

<CardGroup cols={2}>
  <Card title="Manage workspace members" icon="users-gear" href="/administer/workspaces/how-tos/manage-members">
    Add people and update their workspace roles.
  </Card>

  <Card title="Roles and access" icon="user-lock" href="/administer/workspaces/references/roles-and-access">
    See what each workspace role allows.
  </Card>

  <Card title="Delete a workspace" icon="trash-can" href="/administer/workspaces/how-tos/delete-workspace">
    Empty a workspace and delete its subtree.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.