Workspace switching

For users in multiple workspaces — switching, defaults, and custom domains.

Last updated May 12, 2026

When this matters

Many users belong to more than one workspace — an agency consultant in five client workspaces, a founder running a personal brand alongside their company, etc. This doc covers how the platform handles that.

The workspace switcher

The current workspace is shown in the top-left of the dashboard. Click it to open the switcher:

A search field for filtering when you have many workspaces.
A list of workspaces you're in, with your role badge per workspace.
A "Create new workspace" CTA at the bottom.

Switching is fast (no page reload — just a context swap). Your current view re-fetches data for the new workspace; URLs that reference the previous workspace's resources gracefully fall back to the new workspace's home.

Default workspace

Your account has a default workspace that loads on sign-in. Set it at Settings → My account → Default workspace.

Default workspace is per-user, not per-device. Sign in on a new device and your default loads.

While signed in, the active workspace is stored in a cookie (aid:active_org). The cookie expires after 30 days of inactivity in that workspace.

Switching updates the cookie. Closing the browser preserves it.

Per-workspace permissions

Your role in workspace A is unrelated to your role in workspace B. You can be:

Admin of your own startup's workspace.
Editor in a client's workspace.
Viewer in a friend's workspace.

The platform never leaks data across workspaces. Roles are scoped to the active workspace.

Custom domains

Domination workspaces can ship a white-label experience with a custom domain (e.g. portal.acme-agency.com). When you sign in via the custom domain:

The branding is the workspace's own.
The workspace is auto-selected.
The switcher only shows other workspaces that ALSO use the same custom domain (rare; usually just the one).

Signing in via the main app (app.aidomination.app) shows the standard switcher with everything you can access, regardless of custom-domain status.

Recent workspaces

The switcher remembers your last 5 workspaces and surfaces them at the top. Useful for agency consultants flipping between clients.

Workspace removal vs. leave

Leave — you take yourself out. Workspace continues. Done via Settings → My account → Memberships → Leave for each workspace.
Remove — an admin takes you out. You no longer see the workspace.

If the Owner leaves, they must transfer ownership first (see Team invites).

Notifications across workspaces

Notifications are workspace-scoped by default. You can globally mute a workspace at Settings → Notifications → Per workspace.

Channel preferences (email vs. in-app vs. Slack vs. push) are also per-workspace.

API keys and workspaces

API keys live in a workspace. You cannot use a workspace-A key to act on workspace B (the key's bearer would get company_out_of_scope or scope_insufficient).

To work across multiple workspaces programmatically, create one key per workspace.