# Workspaces

Work with teammates in shared workspaces: invite people, pick roles, switch between workspaces, and see how API keys and billing follow the workspace.

A workspace holds your profiles, connected accounts, posts, members, API keys, webhooks and billing. Everything in the dashboard and every API call acts in one workspace at a time.

## Personal and team workspaces

Every person has a **Personal** workspace. It is never shared, and you cannot leave or delete it. Joining another workspace copies nothing out of it.

A **team** workspace has members. You get one by inviting your first teammate from Personal, by accepting an invite, or with **Create workspace** in the account menu at the bottom of the sidebar.

## Invite a teammate

Owners and admins invite from [Members](https://zernio.com/dashboard/users) with **Invite**: an email, a role, and access to all profiles or only some. Members are free.

- An invite is single use and expires after 7 days. Resending renews it.
- Only the address it was sent to can accept it, once that address is verified.
- Accepting adds a membership. Your Personal workspace stays as it is.

From code, [`POST /v1/invite/tokens`](/invites/create-invite-token) creates invite links in a team workspace.

### Your first invite turns Personal into a team

In Personal, **Members** and the account menu offer **Invite teammate**. Sending that first invite turns the workspace into a team in place, under the name you choose.

- It keeps the same ID, profiles, accounts, posts, API keys, webhooks, billing and free accounts.
- What was in it belongs to the team from then on.
- You get a new, empty Personal workspace for solo work.

While you are still the only member, you can undo it: **Undo** on the toast, or **Turn back into Personal** in [Settings](https://zernio.com/dashboard/settings?section=workspace).

The API never converts a workspace, so `POST /v1/invite/tokens` with a key of a Personal workspace returns 409.

### Join through your company domain

An owner or admin can verify the company's email domain in **Settings › General** and let people ask to join. Public email domains never qualify.

Someone who signs up with a verified address at that domain sees **Request to join**. An owner or admin approves or declines.

## Roles

Each workspace has exactly one owner. A member can see all profiles or only the ones they were given.

| Role | What it can do |
|---|---|
| **Owner** | Everything, including transferring ownership and deleting the workspace. Cannot leave without transferring first. |
| **Admin** | Invite and remove people, change roles and profile access, billing, API keys, the activity log, cancel a scheduled deletion. Only the owner can change or remove an admin. |
| **Billing manager** | The workspace's billing: card, balance, invoices, tax details. No members, no API keys. |
| **Member** | Uses the product within their profiles, and creates and revokes their own API keys. |
| **Viewer** | Read only. The server refuses every write. |

## Switch workspaces

Open the account menu at the bottom of the sidebar and pick a workspace, or press `o` then `w`. The dashboard reloads in that workspace.

After a switch in one tab, your other tabs show a banner and stay on their workspace until you reload them. A change made from such a tab is refused.

## API keys belong to a workspace

An API key acts in its workspace and sees only that workspace's profiles, accounts and posts. Your existing keys keep working and see exactly what they saw before workspaces.

- A key created on [API keys](https://zernio.com/dashboard/api-keys) belongs to the workspace that is active when you create it.
- To work in two workspaces from code, use one key per workspace.
- [`GET /v1/users/me`](/users/get-current-user) returns `workspaceId` and `workspaceName`: the workspace the key acts in.
- Your keys in a workspace stop working when you leave it or are removed.

## Billing is per workspace

Each workspace has its own balance, invoices, plan, tax details and auto top-up. Your saved cards belong to you, so paying for a new workspace is one click on a card you already use.

- **Free accounts.** Your 2 free accounts apply to the first workspace you bill. Every other workspace needs a card before its first account.
- **Members never pay.** The workspace pays for what is in it. An invite never asks for a card.
- **Pay-per-use** (numbers, SMS, calls, ads pass-through) is charged to the workspace where you bought it, renewals included.
- **Deals stay put.** A lifetime deal, custom rates or Shopify billing stays on the workspace that had it. Other workspaces pay [standard pricing](/pricing).
- **A failed payment pauses only that workspace.** Your other workspaces keep running.

[Billing](https://zernio.com/dashboard/billing) shows the active workspace. **All workspaces** lists every workspace you own or manage billing for, with its balance and status.

## Leave a workspace or remove someone

Leave from [Members](https://zernio.com/dashboard/users): open your own row and choose **Leave workspace**. Owners and admins remove someone from their row. The dialog counts what changes before you confirm.

- **What stays:** profiles, accounts and posts added in the workspace stay there, with its owner.
- **What returns:** on teams that existed before workspaces, accounts you connected before joining go back to your Personal workspace.
- **Access:** you lose access right away, and you need a new invite to come back.
- **API keys:** yours there stop working. On teams that existed before workspaces, keys used in the last 7 days pass to the owner for 24 hours first.

Automations you made keep running. Their AI steps pause until an owner or admin takes them over or adds a workspace AI key.

## Delete a workspace

Only the owner can delete a workspace, and never a Personal one. Go to **Settings › Danger zone**, enter the 6-digit code we email you, and confirm. The workspace is deleted 48 hours later.

- During those 48 hours members keep working, publishing is paused and scheduled posts are held.
- The owner or an admin can cancel, which releases the held posts.
- Phone numbers, carrier registrations, SIP trunks, messaging senders, creator campaigns and a failed payment block deletion. The dialog links to each one.
- A remaining balance can move to another workspace you own. Balances are not refundable, so otherwise it is lost.

Deletion removes the workspace's data only. People keep their logins and their Personal workspaces.

## Transfer ownership

The owner transfers from **Settings › General**, to someone who is already a member. An admin can ask for ownership from the same place.

- The workspace keeps its billing: balance, invoices and plan. You can move the balance to another workspace you own first.
- The new owner accepts by putting their card on the workspace. Until then nothing changes.
- A lifetime deal or custom rates stay with you, and the workspace moves to standard pricing.
- You become an admin, and only the new owner can remove you.

A transfer is refused while the workspace has an unpaid invoice.

## Dashboard links name their workspace

Any dashboard URL can carry `?workspace=<workspaceId>`, the same ID `GET /v1/users/me` returns. Opening it switches to that workspace first, so a link always shows what the sender saw.

**Copy link to this page** in the command palette (or `c` then `u`) copies the current page with its workspace. Someone who is not a member sees that they have no access.

## If it fails

| Error | Cause | Fix |
|---|---|---|
| 409 on `POST /v1/invite/tokens` | The key belongs to a Personal workspace | Send the first invite from the dashboard, then use the API |
| "You are already in this workspace" | The invite was for a workspace you are in | Open the workspace from the account menu |
| "Verify your email to open this invite" | The invited address is not verified | Send the verification email from the invite page |
| "This invite was sent to another email address" | You are signed in with another address | Sign out and use the invited address |
| 402 when connecting an account | The workspace has no billing yet | The owner adds a card in Billing |

## Related

- [Profiles](/guides/profiles)
- [Build a platform on Zernio](/multi-tenant)
- [Pricing](/pricing)
- [Create an invite](/invites/create-invite-token)
- [Get the current user](/users/get-current-user)