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

# Manage workspaces, AI agents, and member permissions

> Create workspaces, duplicate and group AI agents, and control who can change what

A Chatbase **workspace** groups your AI agents, billing, and team members together. Each workspace has its own AI agents, plan, billing details, and members, none of which are shared with any other workspace. Agencies and larger teams use separate workspaces to keep clients, brands, or environments apart.

> [card] What you can do:
>
> Separate AI agents by team, client, or environment, and control who can change settings versus who can only work on the AI agents.

## Creating a workspace

**1. Open the workspace menu**

Click your avatar at the bottom-left of the sidebar and select **Create or join workspace**.

![The Create or join workspace option in the sidebar menu](https://mintcdn.com/chatbase/xPpOvQF2MdeELnmI/user-guides/workspace/images/manage/team-manage-create-team.png?fit=max\&auto=format\&n=xPpOvQF2MdeELnmI\&q=85\&s=a9f440d445fca104c3151b4bc4b9a7d5)

**2. Add the workspace details**

* **Workspace Name:** the AI agent's display name within the dashboard.
* **Workspace URL:** the workspace slug, visible only in the URL when accessing the workspace on the dashboard.

> [!NOTE]
>
> You can choose any workspace URL you prefer, as long as it's unique and doesn't match an existing workspace.

![Entering the workspace name and URL](https://mintcdn.com/chatbase/4kdBs__Z0wOL088A/user-guides/workspace/images/manage/team-manage-create-team-page.png?fit=max\&auto=format\&n=4kdBs__Z0wOL088A\&q=85\&s=99b33f82cef143aab5558907f257548a)

**3. Create your first AI agent**

You'll be taken to a new page where you can click **New AI agent** and start adding your sources.

![The New AI agent button in a new workspace](https://mintcdn.com/chatbase/xPpOvQF2MdeELnmI/user-guides/workspace/images/manage/team-manage-create-chatbot.png?fit=max\&auto=format\&n=xPpOvQF2MdeELnmI\&q=85\&s=fbece8ababbaada3030abbe2fceaea40)

## Workspaces and plans

* **One user, many workspaces.** You can belong to several workspaces and switch between them from the sidebar.
* **Each workspace has its own plan.** Subscriptions, credits, and limits belong to the workspace, not to your user account.
* **AI agents stay in their workspace.** Duplicating an AI agent copies it inside the same workspace. Agencies in the [Chatbase Experts Program](https://chatbase.co/docs/user-guides/chatbase-experts/experts-program.md) can copy AI agents into a client's workspace with Remix links. There's no self-serve way to move an AI agent between your own workspaces; contact support if you need one moved.

## Duplicating an AI agent

You can duplicate any AI agent by clicking the three dots icon and choosing **Duplicate Agent**.

![The Duplicate Agent option in the three dots menu](https://mintcdn.com/chatbase/xPpOvQF2MdeELnmI/user-guides/workspace/images/manage/team-manage-duplicate-agent.png?fit=max\&auto=format\&n=xPpOvQF2MdeELnmI\&q=85\&s=ae0f74b12ad8acaaea5128ba6b6a8a8b)

### What's not copied

Most AI agent settings are copied, but the following are **not**:

| Not copied | Why |
| - | - |
| **Deployment integrations** such as WhatsApp, Zendesk, Instagram, and the Email channel | Each connection belongs to a single AI agent |
| **Slack, Shopify, and Linear integrations** | Each connection belongs to a single AI agent |
| **Shopify Actions**, such as getting the cart, showing products or orders, updating the cart, placing orders, exchanges, and returns | A Shopify store can't be connected to multiple AI agents at the same time |
| **Slack Notify Action** | A Slack workspace can't be connected to multiple AI agents at the same time |
| **Notion sources** | A Notion workspace can't be connected to multiple accounts |

Reconnect these on the copy after duplicating. A duplicate counts toward your plan's AI agent limit, so you need a free slot (see [AI agents used](https://chatbase.co/docs/user-guides/workspace/usage.md#ai-agents-used)).

## Organizing AI agents in groups

Group related AI agents together on the **Agents** page, for example by client, brand, or use case.

**1. Open the Move to group dialog**

On the **Agents** page, click the three dots icon on an AI agent and choose **Move to group**.

**2. Pick or create a group**

Pick an existing group, or type a new name to create one. Then click **Save**.

The **Agents** page then lists each group under its own heading, with the number of AI agents in it. AI agents that aren't in a group appear under **Ungrouped**. Click the arrow next to a group's name to collapse or expand it, or the pencil icon to rename it.

To remove an AI agent from its group, open **Move to group**, clear the name, and click **Save**.

> [!NOTE]
>
> Groups are personal. Any workspace member can create them, whatever their role. They're saved in your browser, so they don't change what other members see, and they don't carry over to another browser or device.

## Deleting an AI agent

Deleting an AI agent is permanent. To confirm, you type "I understand" in the dialog. If you don't have permission, the option shows "You do not have permission to delete agents".

When you delete an AI agent, Chatbase also deletes its:

* conversations, contacts, and contact custom attributes
* Helpdesk tickets and messages
* sources, Actions, Procedures, and webhooks
* tests and test runs
* Backstage sessions and schedules
* WhatsApp and phone (SIP) number connections

Its slot is freed right away, so you can create a new AI agent immediately. Its past credit use stays on the [Usage](https://chatbase.co/docs/user-guides/workspace/usage.md) page under **Deleted agents**. There is no restore option for a deleted AI agent, so duplicate it first if you might need it again.

## Roles and permissions

Every workspace has four default roles: **Owner**, **Member**, **Viewer**, and **Support Associate**. Support Associate is only offered on plans that include the Chatbase Helpdesk (Basic plan or higher).

| Role | What they can do |
| - | - |
| **Owner** | Change workspace settings (billing, plan, name), delete the workspace, and manage all AI agents within it |
| **Member** | Manage AI agents: train them, see their data, and delete them. They cannot add members or edit billing information |
| **Viewer** | Read-only access to resources and analytics. They can still test AI agents in the Playground and Compare |
| **Support Associate** | Access the Helpdesk only |

See [Modify workspace member role](https://chatbase.co/docs/user-guides/workspace/settings.md#modify-workspace-member-role) for how to change a role, and [Custom roles](https://chatbase.co/docs/user-guides/workspace/settings.md#custom-roles) for Enterprise workspaces.

### Owners and ownership

A workspace can have several Owners, because Owner is a role you can give to any member. One of them is the **primary owner**, marked with a crown icon. The primary owner's role can't be changed and they can't be removed from the workspace.

To hand over a workspace, the primary owner leaves it and picks another member as the new primary owner. That member becomes an Owner. If the primary owner deletes their Chatbase account, primary ownership passes to another Owner automatically.

> [!NOTE]
>
> Invite links expire 24 hours after they're sent to an invitee.

## Frequently asked questions

> [accordion] Can I be a member of more than one workspace?
>
> Yes. One user can belong to several workspaces. Each workspace has its own plan, so upgrading one workspace doesn't upgrade the others.

> [accordion] Can a workspace have more than one Owner?
>
> Yes. Any member can be given the Owner role. One Owner is the primary owner (crown icon), who can't be removed or have their role changed.

> [accordion] How do I transfer ownership of a workspace?
>
> The primary owner leaves the workspace and selects another member as the new primary owner. The new primary owner becomes an Owner.

> [accordion] Can I move an AI agent to another workspace?
>
> Not from the dashboard. Duplicate copies an AI agent inside the same workspace, and Remix links into other workspaces are only available from Agency workspaces in the [Experts Program](https://chatbase.co/docs/user-guides/chatbase-experts/experts-program.md). Contact support to move an AI agent between workspaces.

> [accordion] Can a deleted AI agent be restored?
>
> No. Deleting an AI agent permanently removes it and its conversations, contacts, tickets, sources, and Actions. There's no restore option in the dashboard.

> [accordion] Are Shopify Actions copied when I duplicate an AI agent?
>
> No. Shopify Actions, the Slack Notify Action, the Slack, Shopify, and Linear integrations, deployment channels, and Notion sources aren't copied. Reconnect them on the copy.

## Next steps

> [card] [Usage](https://chatbase.co/docs/user-guides/workspace/usage.md)
>
> Track message credits consumed across the AI agents in this workspace.

> [card] [Workspace settings](https://chatbase.co/docs/user-guides/workspace/settings.md)
>
> Manage billing, your plan, and add-ons.

> [card] [Build Your First AI Agent](https://chatbase.co/docs/user-guides/quick-start/your-first-agent.md)
>
> Create, train, and deploy an AI agent in the new workspace.

> [card] [Two-factor authentication](https://chatbase.co/docs/user-guides/workspace/two-factor-auth.md)
>
> Add a second sign-in step to your own Chatbase account.


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