Skip to main content

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​

  • /workspaces redirects to /workspaces/list.
  • /workspaces/list shows 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​

  1. From the workspaces list, click Create Workspace (top right) or Create Your First Workspace in the empty state.
  2. 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:create are 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) or PERSONAL (single-user).
  1. 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​

  1. Open the workspace.
  2. Click the Settings button in the top-right of the detail page, or go to /workspaces/:workspaceId/settings.
  3. 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.

  1. Open the workspace settings.
  2. 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.

  1. Open the workspace settings.
  2. Choose Delete workspace.
  3. 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:

StatusMeaning
ACTIVENormal operation.
SUSPENDEDTemporarily suspended by an admin or for billing reasons. Read-only.
ARCHIVEDArchived by an owner. Read-only, reversible.
DELETEDSoft-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.