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.
workspace:create permission.
Managing a workspace
Each workspace row on the Settings → Workspaces page exposes its actions. They’re gated byworkspace: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.Next steps
Projects
Create projects inside a workspace.
Roles & permissions
Control workspace-level access.