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

# Create a Workspace

> Learn how to create and manage workspaces to organize your AI agents and team members

## Overview

Workspaces are the foundation for organizing your AI agents and collaborating with team members in Cosmo by Humanizing. Each workspace contains its own agents, knowledge sources, and team members with defined roles.

## What is a Workspace?

A workspace is an isolated environment that contains:

* **AI Agents** - Your configured chat agents with their knowledge bases
* **Team Members** - Collaborators with different permission levels
* **Settings** - Workspace-specific configuration and preferences

<Info>
  You can create multiple workspaces to separate different projects, clients, or departments. Each workspace operates independently with its own agents and team.
</Info>

## Creating Your First Workspace

When you sign up for Cosmo by Humanizing, you'll be prompted to create your first workspace.

### Steps to create a workspace

1. Navigate to the **Create Workspace** page
2. Enter your **Workspace Name** (required)
   * Choose a descriptive name that reflects the purpose (e.g., "Marketing Team", "Customer Support", "Acme Corp")
   * Names can be between 2-100 characters
3. Click **Create Workspace**

<Tip>
  A unique identifier (slug) is automatically generated from your workspace name. This is used internally for routing and API calls.
</Tip>

### After creating a workspace

Once your workspace is created:

* It becomes your **active workspace**
* You're automatically set as the **owner** with full permissions
* You'll be redirected to the agents page where you can create your first AI agent

## Switching Between Workspaces

If you have access to multiple workspaces, you can easily switch between them:

1. Click on the **workspace name** in the top navigation
2. Click the **dropdown arrow** to open the workspace selector
3. Use the search field to find a specific workspace (optional)
4. Click on the workspace you want to switch to

<Note>
  When switching workspaces, you'll be redirected to the agents list of the selected workspace. Each workspace has its own separate set of agents and data.
</Note>

## Creating Additional Workspaces

You can create new workspaces at any time:

1. Click on the **workspace dropdown** in the navigation
2. Click **Create Workspace** at the bottom of the dropdown
3. Fill in the workspace details
4. Optionally invite team members during creation
5. Click **Create Workspace**

## Workspace Roles

Each workspace has a role-based permission system:

| Role       | Description                                                                            |
| ---------- | -------------------------------------------------------------------------------------- |
| **Owner**  | Full access to all workspace features, can delete the workspace and manage all members |
| **Admin**  | Can manage agents, sources, and invite new members                                     |
| **Member** | Can view and interact with agents but has limited management capabilities              |

<Warning>
  Only owners can delete a workspace. This action is permanent and removes all agents, sources, and data associated with the workspace.
</Warning>

## Workspace Settings

Once created, you can manage your workspace through the settings:

* **Rename** - Update the workspace display name
* **Team Members** - Invite, manage, or remove team members
* **Delete** - Permanently remove the workspace (owner only)

To access workspace settings:

1. Navigate to **Settings** in the sidebar
2. Select **Workspace** for general settings
3. Select **Members** to manage team access

## Best Practices

<AccordionGroup>
  <Accordion icon="sitemap" title="Organize by project or team">
    Create separate workspaces for different projects, clients, or departments. This keeps data isolated and makes it easier to manage permissions.
  </Accordion>

  <Accordion icon="users" title="Invite team members early">
    Add collaborators to your workspace so they can help build and maintain agents. Use appropriate roles based on their responsibilities.
  </Accordion>

  <Accordion icon="shield-check" title="Use descriptive names">
    Choose workspace names that clearly indicate their purpose. This helps when switching between multiple workspaces.
  </Accordion>

  <Accordion icon="arrow-right-arrow-left" title="Keep workspaces focused">
    Rather than putting all agents in one workspace, consider creating dedicated workspaces for different use cases to maintain organization.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Your First Agent" icon="robot" href="/agents/overview">
    Learn how to create and configure an AI agent.
  </Card>

  <Card title="Invite Team Members" icon="user-plus" href="/workspace/members">
    Add collaborators to your workspace.
  </Card>
</CardGroup>