Workspaces
Create and manage workspaces — your tenant boundary for apps, data, secrets, and environments.
A workspace is where your apps, data, secrets, and members live. It is the primary tenant boundary for day-to-day work.
Who can access
| Action | Required permission |
|---|---|
| List workspaces | read on account or workspace |
| Create workspace | administer on the parent account |
| View workspace detail | read on the workspace |
| Freeze / export / delete | administer on the workspace |
Prerequisites
- Access to at least one account
administeron an account to create new workspaces
Create a workspace
UI screenshots live in public/images/customer-portal/ — add captures from the portal and reference them here as guides are polished.
Open Workspaces
In the sidebar under Overview, click Workspaces.
Click Create workspace
Enter a name (e.g. Production or Acme Dev). The system assigns a URL slug and UUID automatically.
Confirm
The new workspace appears in the list. Click it to open the detail page.
Each new workspace is provisioned with dev, staging, and prod environments.
Workspace list
The table shows Name, Account, Tenancy model, Status, Region, and Created date. Click a workspace name to open its detail page.
Workspace detail page
The detail page includes:
- Account link — parent account
- Slug and UUID — copy the workspace ID with the copy button (needed for API calls and Shell app registration)
- Environments — dev / staging / prod with status
- Apps — registered apps in this workspace (links to Apps pillar)
- Coderunners — runners when Coderunner integration is configured
- Recent activity — workspace-scoped audit feed
- Actions menu — freeze, export, or offboard (requires
administer)
Select a workspace globally
Many pages (Data Vault, Files, Secrets, Process Log) use the workspace picker in the top navigation bar. Select a workspace once and it persists across those pages.
The workspace UUID appears in the URL: /workspaces/{uuid}/… — bookmark it or copy from the detail page.
Freeze or offboard
Account admins with administer can freeze a workspace (blocks writes) or start offboarding from the workspace Actions menu. Offboarding is irreversible after the hard-delete window — coordinate with your team first.
Troubleshooting
| Problem | Likely cause | What to do |
|---|---|---|
| Cannot create workspace | Missing administer on account | Ask an account owner |
| Workspace picker empty | No workspaces in your accounts | Create one or ask to be added as a member |
| Environments stuck provisioning | Saga still running | Check Activity Log; contact support if > 10 min |
Related API
GET /v1/workspaces— list workspacesPOST /v1/workspaces— create workspaceGET /v1/workspaces/{workspace_id}— detailGET /v1/workspaces/{workspace_id}/environments— environmentsGET /v1/workspaces/{workspace_id}/audit— audit feed
See Core concepts for the account → workspace hierarchy.