Workspaces

A workspace is the container for everything you do in SuperSpace. Your sites, domains, DNS zones, backups, billing, and the people you collaborate with all live inside a workspace. You can belong to more than one, and you switch between them as you work.

What lives in a workspace

Almost everything in SuperSpace belongs to exactly one workspace:

• Sites — your WordPress installations.
• Domains and DNS — the domains attached to those sites and their DNS zones.
• Billing — the subscription, payment method, and invoices that pay for the sites in the workspace.
• People and roles — the users who can access the workspace and what each of them is allowed to do.
• Contacts — the owner, billing, and technical contacts recorded for the workspace.

Because everything is scoped to a workspace, the workspace you're currently in decides which sites and domains you see in the sidebar and which billing you're looking at. There is no combined "all workspaces at once" view — you're always working inside exactly one active workspace at a time, and you switch to see the others.

Finding your workspaces

To see every workspace you belong to, open the account switcher in the sidebar (its trigger shows the name of your current workspace) and click View All in the Workspaces panel that appears. This opens the full workspace list (headed My Workspaces), which shows each workspace by Name alongside Your Role in it, and lets you jump into any of them.

To create another top-level workspace, click New Workspace on this page. (To create a sub-workspace under one you already manage, use the Sub-Workspaces card on that workspace's page instead — see Sub-workspaces.)

Switching between workspaces

You can switch the active workspace from two places:

• The account switcher in the sidebar. The switcher's trigger shows the name of your current workspace. Clicking it opens a panel headed Workspaces that lists your recent workspaces, with a Search workspaces… box to filter them all by name and a View All link to the full list. If a workspace has sub-workspaces, hovering it reveals those children in a second column so you can switch straight to one of them.
• The My Workspaces page. Click Switch To Workspace next to any workspace in the list.

Either way, SuperSpace confirms with a "Switched to <workspace name>" message, and the sidebar then reflects the sites, domains, and billing of the workspace you moved into.

The workspace page (Settings)

Each workspace has its own settings page, reached from Settings in the sidebar. It's where you review and manage the workspace itself rather than any single site. The page is organized into cards:

• Contacts (subtitle Workspace Contact Details) — the Owner Contact, Billing Contact, and Technical Contact on file, plus any other contacts you've added.
• Users (subtitle User Management and Access) — everyone with access to the workspace and their roles, with an Invite button to add more (admins only).
• Sub-Workspaces — workspaces nested beneath this one, with a Create Sub-Workspace button (admins only). Creating a sub-workspace that the parent manages and bills for is a reseller feature — see Sub-workspaces and resellers.
• Brands — only shown on reseller workspaces; covers white-label branding (see Resellers).

The Edit button at the top of the page lets an admin rename the workspace and change a few of its settings, such as the contacts and notification webhooks.

Users and roles at a glance

Each person in a workspace holds exactly one role there, and that role decides what they can see and do. The same person can hold a different role in a different workspace — being an admin in one workspace doesn't make you an admin everywhere.

SuperSpace has five built-in roles, from least to most access:

Inviting people, changing their roles, and removing them are workspace administration tasks rather than concepts — for the step-by-step, see Inviting users and managing roles.

Sub-workspaces and resellers

A workspace can contain sub-workspaces — child workspaces nested beneath it. Sub-workspaces are a reseller feature: a reseller creates one per customer so each customer's sites and billing stay separate while the reseller manages them all. The parent workspace must be a reseller for sub-workspaces to be billed through it, so if your workspace isn't a reseller you won't get the full sub-workspace behaviour described here.

Two settings shape how a sub-workspace behaves:

• Inherit Billing — offered when the parent is a reseller. When on, the sub-workspace is billed to its parent: the parent pays for the child's usage, and people in the child workspace don't see a separate billing dashboard. When off, the sub-workspace has its own payment method and is billed independently.
• Inherited roles — as noted above, a role on the parent cascades down to the child.

Reseller and white-label branding features are covered in detail on the Resellers page.

Leaving a workspace

If you no longer need access to a workspace, you can remove yourself from it using the Leave Workspace action on your own row in the Users card. A couple of guardrails apply:

• You can't leave a workspace if you're its only remaining user, or if it's the only workspace you belong to.
• You can't leave by way of a role that was inherited from a parent workspace — that has to be changed on the parent.

Working with workspaces from the API

In the API, a workspace is an account. Most account-scoped requests take an X-Auth-Account header that names which workspace the request applies to — the API equivalent of the active workspace you pick in the dashboard. For example, to list every workspace your credentials can reach:

curl -H "Authorization: Bearer $SUPERSPACE_TOKEN" \
  https://control.superspace.nl/api/accounts

Account management endpoints (creating workspaces, managing users, and similar) are not available via OAuth — they require a session or API-key credential. See the Accounts API for the full request and response shapes.