Create and manage workspaces

Workspaces are created from the left sidebar, and existing workspaces can be edited, archived, restored, or permanently deleted from there.

Prerequisites

To create, archive, or delete a workspace, you need the organization Admin or Owner role. To edit workspace information, the organization Admin or Owner role can perform it, and so can the Workspace Manager of the target workspace.

Creating a workspace

1. Click New workspace. If you already have one or more workspaces, click the current workspace name in the left sidebar (or Select workspace when none is selected), and click New workspace from the menu that opens.

2. Enter a Workspace name in the dialog. You can also enter a Description if needed.

3. Click Create workspace. When creation is complete, a banner showing Workspace created appears in the lower-right corner, and you are taken to the new workspace automatically.

New workspace dialog

Workspace created banner

If your plan has a workspace limit and the limit has been reached, New workspace is disabled and the message "Your organization has reached the workspace limit. Delete a workspace to free up a slot." appears.

If the limit has been exceeded, a warning "Your organization is over the workspace limit" appears in the left sidebar. In either case, permanently delete unused workspaces to free up slots, or contact your administrator about upgrading your plan.

Note: Archived workspaces also count toward the limit.

Editing workspace information

1. Click Menu next to the workspace name in the left sidebar.

2. Click Workspace settings.

3. Change the Workspace name or Description.

4. Click Save changes.

Workspace settings form

Archiving a workspace

When you archive a workspace, it is hidden from the workspace list. Archived workspaces can be restored later.

1. Click Menu next to the workspace name in the left sidebar.

2. Click Archive.

3. Click Archive in the confirmation dialog. When archiving is complete, a banner showing Workspace archived appears in the lower-right corner.

Archive confirmation dialog

Restoring an archived workspace

1. Click Settings at the bottom of the left sidebar.

2. Click Archived workspaces.

3. Click Restore in the row of the workspace you want to restore.

4. Click Restore in the confirmation dialog. When the restore is complete, a banner showing Workspace restored appears in the lower-right corner.

Restore an archived workspace

Deleting a workspace

Deletion cannot be undone. Archive the workspace before deleting it.

1. Click Settings at the bottom of the left sidebar.

2. Click Archived workspaces.

3. Click Delete workspace in the row of the workspace you want to delete.

Delete an archived workspace

1. Enter the workspace name in the input field. (This step prevents accidental deletion — verify the workspace name you are deleting.)

Delete workspace confirmation dialog

1. Click Delete workspace. When deletion is complete, a banner showing Workspace permanently deleted appears in the lower-right corner.

When you delete a workspace, all data associated with it (uploaded specifications, knowledge base documents and chunks, code archives, workflow run history, chat history, GitHub integration settings, and so on) is permanently deleted. This action cannot be undone.