> ## Documentation Index
> Fetch the complete documentation index at: https://www.botgauge.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces and projects

> Create, rename, and delete BotGauge workspaces and projects, find their IDs, and understand Free plan limits and how to request more workspaces.

## Workspaces

A workspace is a team's space. It contains projects, and it has its own members and roles.

### Create a workspace

An org owner or admin creates a workspace from **Organization, Workspaces** or from the workspace switcher. Choose **New workspace**, type a name, and choose **Create**. The new workspace is empty and the creator is its Admin. Org admins can open it straight away.

![The New workspace dialog asking for a name](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/new-workspace.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=f70f6badcdf046538c8ac7a4a77c9798)

Create a workspace.

### Rename a workspace

A workspace admin (or an org admin) edits the name under **Workspace, General** and saves. The new name appears for everyone in the workspace.

![The Workspace General settings page with name, ID, and Delete workspace](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/workspace-general.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=1631072b717ed9b0deb16ff39d1136a1)

Workspace, General.

### Delete a workspace

Deleting a workspace deletes all of its projects, agents, reports, and API keys, and its members lose access. The console shows how many projects are affected and warns that this can't be undone. An organization must keep at least one workspace, so the last workspace can't be deleted.

> [!WARNING]
>
> Deleting a workspace revokes its API keys. Anything still sending traces with those keys will start receiving authentication errors.

### Plan limits

The Free plan includes one workspace, and it also limits organization members. A `limit` of `null` in the plan limits response means unlimited. If a Free organization needs more workspaces, an org owner or admin can choose **Request more workspaces**. The request is recorded and BotGauge staff are emailed. When staff raise the plan, the limit goes away. Asking again while a request is open returns the same request instead of creating a second one.

![The Workspaces page on the Free plan showing the one-workspace limit](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/free-plan-workspace-limit.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=64d408d09460d0d2d1208444cf545f4f)

On the Free plan, the Workspaces page shows the limit.

![The workspace request confirmation](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/workspace-request-sent.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=e351537ef81cb427af6aede5196588c8)

After you request more workspaces, the console shows that the request was sent.

## Projects

A project holds agents and logs, and it has its own secrets and API keys. Everyone in the workspace opens every project in it, with their workspace role.

### Create a project

A workspace Member or Admin creates a project from **Workspace, Projects** or from the switcher. Choose **New project**, type a name, and choose **Create project**. Projects are unlimited on every plan.

![The Workspace Projects table with agent counts and created dates](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/workspace-projects.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=cbf9f3eb294c07944135f046248a9db7)

Workspace, Projects.

![The New project dialog asking for a name](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/new-project.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=25dc186809bfe70fad49e14310208a6e)

Create a project.

### Rename a project

A workspace Member or Admin edits the name under **Project, General** and saves.

![The Project General settings page with name, ID, and Delete project](https://mintcdn.com/botguage/CvMAYy1jOk7D5CuB/images/platform/project-general.jpg?fit=max\&auto=format\&n=CvMAYy1jOk7D5CuB\&q=85\&s=f819df09ce3e04dfb8e30bb0b964a80c)

Project, General.

### Delete a project

Only a workspace Admin can delete a project. The project and its agents, reports, secrets, and API keys are deleted. The console warns that this can't be undone.

## Workspace and project IDs

The General page of a workspace or project shows its ID, with a copy button. The console notes that the ID is used by the API and the CLI.

Set up workspaces and projectsOpen [BotGauge](https://cloud.botgauge.com) to create a workspace and add your first project.

[Try BotGauge →](https://cloud.botgauge.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.