---
title: "Workspaces"
description: "Separate keys, routing rules and activity inside one account and one balance."
---

# Workspaces

A workspace groups API keys inside your account. Use one per team, client or app. Every workspace spends from the same balance.

## What each workspace has

| Part | Per workspace or per account |
|---|---|
| API keys | Per workspace. A key belongs to the workspace it was made in. |
| Routing rules | Per workspace. The rules on a workspace's Routing page apply to every key in it. |
| Activity, logs and the CSV export | Per workspace. Activity shows the open workspace only. |
| Balance, top-ups, auto top-up, saved card and invoices | Per account. Every workspace spends from one balance. |
| AI providers | Per account. A provider key you add serves every workspace. |
| Privacy settings | Per account. |
| Referral code and bonus credit | Per account. |

## The default workspace

Every account has a **Default** workspace. It holds every key made before workspaces existed, and keys made without naming a workspace. It cannot be deleted.

## Make and switch workspaces

1. Open [/workspaces](https://plaingateway.com/workspaces) and press **New workspace**, or pick **New workspace** in the menu at the top left.
2. Give it a name of 1 to 60 characters. The slug, used in the workspace's address, is made from the name; you can change it. A slug has lowercase letters, numbers and single hyphens, up to 40 characters, and is unique among your workspaces. A description is optional, up to 280 characters.
3. Press **Create workspace**. The new workspace opens on its API Keys page.

The menu at the top left shows your account name and the open workspace. Pick another workspace there to switch to it. You stay on the same page, so Keys stays Keys. **All workspaces** opens the list, with each workspace's spend this month and its number of keys.

A workspace's pages are at `/workspaces/<slug>/activity`, `/keys`, `/routing` and `/settings`. The old addresses (/dashboard, /activity, /settings/keys and the routing part of /settings/preferences) open the default workspace's pages.

## Rename or delete a workspace

On a workspace's **Settings** page you can change its name, slug and description. A new slug changes the workspace's addresses; the old ones stop working.

**Delete workspace** on the same page:

- Every API key in the workspace stops working at once, and cannot be turned back on. Requests that use them are refused.
- Your balance, your other workspaces and their keys are not affected.
- The workspace's slug is free for a new workspace.
- It cannot be undone.

## Rules

- Spend this month and Activity's totals count requests up to the last hourly update. Logs show each request as it happens and are kept for 7 days.
- A routing rule change reaches the gateway within about 10 seconds.
- The first top-up bonus is once per person. See [Bonus and referral credit](bonus-and-referral-credit.md).
- A suspension applies to the whole account: every workspace stops, and every workspace comes back when it is lifted.
- **Delete account** on the Account page stops every key in every workspace. The balance and records stay, and support can restore the account if you ask.
