Skip to main content
A workspace is the top-level container in Unkey. Your team and roles, billing plans and limits, root keys, keyspaces and keys, and Compute all belong to exactly one workspace. A root key from one workspace can’t touch another. Most teams need one workspace. Create a second when you need hard isolation, such as separate billing for two business units or a client whose data must never sit next to yours.

Create a workspace

1

Open the creation page

Go to app.unkey.com/new, or pick New workspace in the workspace switcher. Signing in with a new account lands you here automatically.
2

Pick what you're building

Choose Compute or API management and click Continue. Your choice only decides where you land after creation (Projects or Keyspaces). Both products are available in every workspace.
3

Name the workspace and confirm the URL handle

Enter a name between 3 and 50 characters. The dashboard fills in the URL handle (the slug) from the name, and you can edit it. If the slug is taken, you’ll see an error when you submit.
Create Company Workspace form with a workspace name entered and the URL handle filled in from it
4

Create

Click Create workspace. The workspace starts on the free tier with the free limits and no Compute plan. You can deploy once you pick a plan under Plans.

Slug and ID

string
required
The URL handle in every dashboard URL, as in app.unkey.com/<slug>/.... It must be unique across Unkey and can’t be changed after creation. Use 3 to 64 lowercase letters, digits, and single hyphens, with no hyphen at the start or end.
string
A generated identifier that starts with ws_. Use it when an API call or a support request needs to name the workspace. Copy it from Settings > General.

General settings

Settings > General holds the workspace name, the workspace ID, and the GitHub App connection.
General settings page showing the workspace name, the workspace ID with a copy button, and the Unkey GitHub App marked Installed under Integrations
string
required
Between 3 and 50 characters. Only your team sees it, not your users. Only an admin can rename the workspace. For other roles, the field is disabled with “Admin access required to rename the workspace” below it. Renaming writes a workspace.update audit log entry.
string
Read-only, with a copy button.
connection
Shows whether the Unkey GitHub App is installed. Click Install to choose the repositories Unkey can read on GitHub. Once installed, the card shows Installed and the button changes to Manage. Compute needs this connection to deploy an from a repository and to create preview for pull requests. Workspaces that only use API management can leave it disconnected.
The rest of the Settings menu covers Team, Log Drains, Billing, Usage, Limits, and CLI sessions. Root Keys and Environment Variables have their own entries in the main sidebar. See Root keys.

Delete a workspace

You can’t delete a workspace from the dashboard or the API. To close one, email support@unkey.com from a workspace admin’s address. Cancel any paid plans under Settings > Billing first so nothing renews while support handles the request.
Last modified on November 3, 2026