Skip to main content
A workspace groups related projects inside your organization — for example, one workspace per team or product line. Onboarding creates your organization’s first 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>/…).
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.
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) 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.

Delete

Deleting a workspace is permanent and removes its projects and everything in them, including prompts, skills, sessions, and API keys. The dialog counts the projects, members, prompts, tools, and API keys it will remove. To prevent accidents, it requires you to type the workspace’s name to confirm.
The default workspace can’t be archived or deleted — its controls are hidden.

Next steps

Projects

Create projects inside a workspace.

Roles & permissions

Control workspace-level access.