Admin Workspace Management

Platform admins manage workspaces from Admin → Workspaces (/admin/workspaces).

Capabilities

Action	API
List / search / filter (status, owner)	GET /admin/workspaces
View detail	GET /admin/workspaces/:id
Create	POST /admin/workspaces
Edit	PATCH /admin/workspaces/:id
Suspend	POST /admin/workspaces/:id/suspend
Activate	POST /admin/workspaces/:id/activate
Archive	POST /admin/workspaces/:id/archive
Restore	POST /admin/workspaces/:id/restore
Delete (safe only)	DELETE /admin/workspaces/:id
Transfer owner	POST /admin/workspaces/:id/transfer-owner

Create/edit fields: name, slug (unique), owner (active user), status, optional admin settings (billing email, limits, internal note stored in workspace.settings.admin JSON).

Workspace statuses

Status	Admin UI	Normal users
ACTIVE	Full management	Full access
SUSPENDED	Visible, badge	No API access; hidden from active switcher; shown disabled in list if visible
ARCHIVED	Visible, badge	Hidden from switcher; API returns WORKSPACE_ARCHIVED

Safe delete

Hard delete only when workspace has no meaningful activity (extra members, files, AI, billing, webhooks, API keys, licenses, tickets).

Otherwise:

• Delete blocked with: "This workspace has existing users or activity. Archive it instead."
• May auto-archive if not already archived

Owner / member safety

• New owner must be an active user; owner OWNER membership created without duplicate
• Transfer demotes previous owner to ADMIN when applicable
• Cannot suspend/archive/delete actor's only owned active workspace (self-lockout protection)
• Member list is view-only in admin detail drawer (full member CRUD deferred)

User-side behavior

• GET /workspaces returns ACTIVE + SUSPENDED (archived hidden)
• Only ACTIVE workspaces become activeWorkspace after login
• No active workspace → /workspace-unavailable with friendly message
• Workspace-scoped APIs return 403 + WORKSPACE_SUSPENDED or WORKSPACE_ARCHIVED

Admins using /admin/workspaces are not affected — they can still view and manage suspended/archived records.

See Workspaces & Team and Authentication.

Demo restrictions

Demo read-only admin cannot create/edit/suspend/archive/delete workspaces. See Demo Mode.