Workspaces

A workspace groups related projects inside your organization — 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>/…).

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 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.

​

Next steps