- Billing: every workspace has its own Stripe subscription, payment method, and invoices. Usage in one workspace does not affect another.
- Team members: each workspace has its own set of members and roles. Being an admin in one workspace does not grant access to another.
- Limits: request limits, data retention, and resource allocations are tracked per workspace.
- APIs and keys: keyspaces, API keys, identities, roles, and permissions are scoped to the workspace that created them.
- Projects: deploy projects, apps, environments, and deployments belong to a single workspace.
- Root keys: API credentials for programmatic access are issued per workspace and only grant access to that workspace’s resources.
Slug and ID
Every workspace has two identifiers:- Slug is the URL handle you choose when creating the workspace (for example,
acme). It appears in all dashboard URLs (app.unkey.com/acme/...) and must be globally unique. The slug accepts lowercase letters, numbers, and hyphens, and cannot start or end with a hyphen. The slug cannot be changed after creation. - Workspace ID is a system-generated identifier prefixed with
ws_(for example,ws_abc123). Use this when calling the Unkey API. You can copy it from Settings > General.
Create a workspace
- Navigate to the workspace creation page at
app.unkey.com/new. - Enter a workspace name (3 to 50 characters).
- Set a slug. Unkey auto-generates one from the name, but you can edit it.
- Click Create workspace.
Switch between workspaces
If you belong to multiple workspaces, use the workspace switcher in the sidebar to move between them.
