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

# Workspaces

> Group related projects within an organization.

A workspace groups related [projects](/docs/platform/projects) inside your [organization](/docs/platform/organizations) — for example, one workspace per team, product line, or environment tier. Every organization starts with a default workspace, and you can add more as you grow.

## Creating a workspace

Open **Settings → Workspaces** and choose **New workspace**. A workspace needs:

* **Name** — its display name (up to 120 characters).
* **Slug** — the lowercase, hyphenated identifier used in dashboard URLs (`/org/<org>/ws/<workspace>/…`).

<Note>
  The slug is fixed once the workspace is created — you can rename a workspace later, but its slug stays the same so existing links keep working.
</Note>

Creating a workspace requires the `workspace:create` permission.

## Managing a workspace

Each workspace row on the **Settings → Workspaces** page exposes its actions. They're gated by `workspace:update` (rename, archive, discovery) and `workspace:delete` (delete).

### Rename

Renaming changes the workspace's display name only. The slug is left untouched.

### Archive

Archiving hides a workspace from the workspace switcher and makes its projects and data inaccessible — but nothing is deleted. Archiving is reversible: restore the workspace to bring it back to active. Use it to retire a workspace without losing its history.

### Platform discovery

The **platform discovery** toggle controls whether to11 may list a provider's model catalog for the workspace automatically. When it's on, connecting a provider can populate its available models for you; when it's off, you enter models manually. See [Providers](/docs/deploy/concepts/providers) for how model lists are used.

### Delete

Deleting a workspace is permanent and removes its projects, members, prompts, tools, API keys, and traces. To prevent accidents, the dialog summarizes what will be removed and requires you to **type the workspace's name to confirm**.

<Warning>
  The default workspace can't be archived or deleted — its controls are hidden.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Projects" icon="folder" href="/docs/platform/projects">
    Create projects inside a workspace.
  </Card>

  <Card title="Roles & permissions" icon="shield-check" href="/docs/platform/roles-and-permissions">
    Control workspace-level access.
  </Card>
</CardGroup>