---
title: Workspaces
description: 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.

```mermaid
stateDiagram-v2
  direction LR
  [*] --> Active: Create workspace
  Active --> Active: Save changes
  Active --> Archived: Archive workspace
  Archived --> Active: Unarchive workspace
```

## 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](/pt-BR/dashboard#organizations-and-workspaces).

## Switch workspaces

1. **Open the workspace switcher**

    Select your organization and workspace at the top of the sidebar.

2. **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**.

3. **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.

1. **Start from the switcher**

    Open the workspace switcher and select **Create new workspace**, at the bottom of the list.

2. **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.

3. **Describe it**

    Optionally, add a **Description** of up to 240 characters, so teammates know what the workspace is for.

4. **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](/pt-BR/dashboard/api-keys).

If **Create new workspace** isn't in the list, your role can't create workspaces. Ask a Creator.

## Edit a workspace

1. **Open its settings**

    Switch to the workspace, and open **Settings → Workspace → General**.

2. **Change the details**

    Edit the **Workspace name** or the **Workspace description**. The same rules apply as when you create one.

3. **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.

1. **Open its settings**

    Switch to the workspace, and open **Settings → Workspace → General**.

2. **Archive it**

    Under **Workspace Archive**, select **Archive workspace**.

:::warning[No confirmation step]
**Archive workspace** acts as soon as you select it. Check that you're in the right workspace first: its name and environment are at the top of the sidebar.
:::

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](/pt-BR/dashboard/audit-logs) and [Webhooks](/pt-BR/core/webhooks).

## Where to go next

**[API keys](/pt-BR/dashboard/api-keys)**

Create keys for the new workspace

**[Roles & permissions](/pt-BR/dashboard/roles-permissions)**

Who can create, edit, and archive workspaces

**[Audit and usage logs](/pt-BR/dashboard/audit-logs)**

What happened in each workspace
