Creating and Managing Workspaces
A workspace lives inside a tenant and is owned by an organization within that tenant. Each workspace has its own projects, members, settings, and activity feed, fully isolated from every other workspace.
Viewing your workspaces
/workspacesredirects to/workspaces/list./workspaces/listshows every workspace you are a member of.- Use the search box to filter by name (matched as you type).
- Toggle between grid and list views with the icons next to the search box (hidden on small screens).
- The footer shows
Showing X of Y workspaces; if there are more results than the current page can hold, the page indicates that pagination is upcoming.
The list comes from the membership-scoped myWorkspaces query — you will only see workspaces you actually belong to. There is no separate "browse all" view for regular users.
Opening a workspace
Click any workspace card or row, or go to /workspaces/:workspaceId directly.
The detail page shows three clickable summary cards — Projects, Members, Activity — each opening the matching section, plus a Workspace Information card with the workspace ID, domain, contact email, website (clickable), and creation date.
If you don't have workspace:read for that workspace, the page renders an Access Denied message.
Creating a workspace
- From the workspaces list, click Create Workspace (top right) or Create Your First Workspace in the empty state.
- You land on
/workspaces/new. Fill in the form:
- Workspace Name — at least 2 characters. Becomes the display name.
- Slug — auto-generated from the name; URL-friendly (lowercase letters, numbers, hyphens). You can override it.
- Tenant — defaults to the shared Burdenoff tenant if you have one; otherwise the first tenant you belong to.
- Organization — only orgs where you have
workspace:createare listed. If you have no eligible org, the page shows a Permission Required card instead of the form. (If the permission lookup itself is failing, a warning banner appears but the form remains usable; the gateway makes the final decision on submit.) - Workspace Type —
TEAM(collaborative, default) orPERSONAL(single-user).
- Click Create Workspace. On success you land on the new workspace's detail page.
Permissions: workspace:create on the chosen organization.
A default set of resources is provisioned for you so the workspace is usable immediately.
Editing a workspace
- Open the workspace.
- Click the Settings button in the top-right of the detail page, or go to
/workspaces/:workspaceId/settings. - Change Name, Contact Email, Domain, or Website and click Save Changes. You can also manage workspace-level tags from the same page — see Workspace settings.
Permissions: workspace:update. Without it, the Settings button is hidden on the detail page and the settings page itself shows an Access Denied card.
Archiving a workspace
Archive when you want to keep the workspace's history and data but pause active use. The workspace stays in your list but is shown as read-only and de-emphasized in switchers.
- Open the workspace settings.
- Choose Archive workspace and confirm.
Permissions: workspace:archive.
Archive is reversible — choose Reactivate workspace from the same screen to bring it back to ACTIVE. Reactivation requires workspace:update (not the archive permission), so anyone with edit rights can lift an archive.
Deleting a workspace
Deletion soft-deletes the workspace; data is retained for the standard recovery window before being purged.
- Open the workspace settings.
- Choose Delete workspace.
- Type the workspace name to confirm.
Permissions: workspace:delete. Only the workspace owner can delete, and only when no critical attached resources block it.
Workspace status
A workspace has one of four statuses, surfaced as a badge on the detail page:
| Status | Meaning |
|---|---|
ACTIVE | Normal operation. |
SUSPENDED | Temporarily suspended by an admin or for billing reasons. Read-only. |
ARCHIVED | Archived by an owner. Read-only, reversible. |
DELETED | Soft-deleted, awaiting purge. |
Tips
- You can belong to many workspaces. Switch between them from the workspace selector in the shell.
- Workspace data is fully isolated — projects, members, and activity in one workspace are never visible from another.
- The slug appears in URLs and integrations, so pick something short and stable; the display name can change freely later.