Workspaces
Switch between your organization's workspaces, create new ones, edit their name and description, and archive the ones you no longer use.
A workspace is an isolated area of your organization, with its own API keys, batches, files, and logs. Every member can switch between the workspaces of their organization. Creating, editing, and archiving workspaces belongs to the Creator role.
This page shows how to move between workspaces, create one, change its details, and archive it when it’s no longer needed. A workspace stays active from the moment it’s created until someone archives it, and an archived workspace can be restored.
What a workspace holds
Some things belong to one workspace, and others apply across the whole organization.
| Belongs to the workspace | Applies across the organization |
|---|---|
| API keys | Members and their roles |
| Batches | Billing |
| Uploads and exports | Models |
| Audit and usage logs | Notifications and webhooks |
| Its name, description, and ID |
So a key created in one workspace doesn’t work in another, and the logs you read are the current workspace’s. A member’s role, on the other hand, is the same in every workspace. See Dashboard overview.
Switch workspaces
Open the workspace switcher
Select your organization and workspace at the top of the sidebar.
Find the workspace
Search or scroll the Workspaces list. A badge marks each workspace’s environment, such as Prod for production or Sbx for sandbox, and archived workspaces come last, marked archived.
Select it
The dashboard stays on the page you were on, now showing the workspace you picked. A message confirms the switch, and its Undo takes you back for a few seconds.
The dashboard remembers the last workspace you picked in each organization, and opens it the next time you sign in.
Create a workspace
Only Creators can create workspaces.
Start from the switcher
Open the workspace switcher and select Create new workspace, at the bottom of the list.
Name it
Enter a Workspace name of up to 50 characters, such as growth-team. Names use lowercase letters, numbers, and hyphens: as you type, capitals become lowercase, and other characters become hyphens.
Describe it
Optionally, add a Description of up to 240 characters, so teammates know what the workspace is for.
Create it
Select Create workspace. The dashboard switches to the new workspace.
A new workspace starts without API keys of its own. Create the keys its systems need under Settings → Workspace → API keys. See API keys.
If Create new workspace isn’t in the list, your role can’t create workspaces. Ask a Creator.
Edit a workspace
Open its settings
Switch to the workspace, and open Settings → Workspace → General.
Change the details
Edit the Workspace name or the Workspace description. The same rules apply as when you create one.
Save
Select Save changes.
The Workspace ID at the top of the page is the workspace’s read-only identifier, with a button to copy it. Renaming a workspace doesn’t change its ID, so its keys and the links to its pages keep working.
Members whose role can’t update workspaces see the same page with the fields turned off.
Archive a workspace
Archiving revokes API access to a workspace, while preserving its data. Use it for a workspace you no longer use, instead of leaving its keys working.
Open its settings
Switch to the workspace, and open Settings → Workspace → General.
Archive it
Under Workspace Archive, select Archive workspace.
An archived workspace stays in the workspace switcher, at the end of the list and marked archived. To restore access and connections, switch to it, open Settings → Workspace → General, and select Unarchive workspace.
Archiving and unarchiving belong to the Creator role. For other roles, the button is turned off.
Records of workspace changes
Creating a workspace, changing its settings, archiving it, and unarchiving it are recorded in the audit log, under Observability → Audit, and sent as the workspace-creation, workspace-update, workspace-archival, and workspace-unarchival webhook events. See Audit and usage logs and Webhooks.