Pular para o conteúdo
AvraAvra
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

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.

Where to go next

Esta página foi útil?