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

# Workspaces

> Organize your agents and files into workspaces — shared project folders that keep related resources together.

## Overview

Workspaces are organizational containers that group related agents and files together. Think of them as project folders — each workspace has its own file system, a collection of assigned agents, and a dedicated view in the sidebar.

Use workspaces to:

* **Organize by project** — keep all agents and files for a client, product, or initiative in one place
* **Manage shared files** — upload reference documents, images, and data that the super agent can access across conversations
* **Group agents** — assign agents to one or more workspaces so they appear together and share context

## Creating a workspace

<Steps>
  <Step title="Open the create dialog">
    In the sidebar, find the **Workspaces** section and click the **+** button next to the heading.

    <Frame caption="The sidebar showing the Workspaces section with the + button to create a new workspace">
      <img src="https://mintcdn.com/creaoagent/L7jvWhXluKR0aaCS/images/workspaces-sidebar.png?fit=max&auto=format&n=L7jvWhXluKR0aaCS&q=85&s=0c138e23d9137fce78146f08975d4fa2" alt="Sidebar with Workspaces section and create button" width="240" height="800" data-path="images/workspaces-sidebar.png" />
    </Frame>
  </Step>

  <Step title="Name and configure">
    Enter a name for your workspace and optionally select agents to include from the start.

    <Frame caption="The Create Workspace dialog from the Workspaces listing page">
      <img src="https://mintcdn.com/creaoagent/L7jvWhXluKR0aaCS/images/workspaces-create.png?fit=max&auto=format&n=L7jvWhXluKR0aaCS&q=85&s=9e2fb8a747a7f562d3e33bc034abad9c" alt="Create Workspace dialog with name input, Cancel, and Create buttons" width="1280" height="800" data-path="images/workspaces-create.png" />
    </Frame>
  </Step>

  <Step title="Open your workspace">
    Click the workspace name in the sidebar to open its edit panel. This is your workspace command center — manage the name, agents, and files all in one view.

    <Frame caption="The workspace edit panel with sections for name, Agents, and Files">
      <img src="https://mintcdn.com/creaoagent/L7jvWhXluKR0aaCS/images/workspaces-detail.png?fit=max&auto=format&n=L7jvWhXluKR0aaCS&q=85&s=607f703df776163bc46c00229e11ef2e" alt="Workspace edit panel showing name, agents, and files sections" width="1280" height="800" data-path="images/workspaces-detail.png" />
    </Frame>
  </Step>
</Steps>

## Workspaces listing

You can also view all your workspaces at a glance from the **Workspaces** page (accessible via the sidebar). Each workspace appears as a card showing its name, description, and resource counts.

<Frame caption="The Workspaces listing page with workspace cards">
  <img src="https://mintcdn.com/creaoagent/L7jvWhXluKR0aaCS/images/workspaces-list.png?fit=max&auto=format&n=L7jvWhXluKR0aaCS&q=85&s=bae559f15a41f44deb52475389f33a2d" alt="Workspaces listing page showing workspace cards" width="1280" height="800" data-path="images/workspaces-list.png" />
</Frame>

## The workspace file system

Each workspace has its own file storage area. Files uploaded to a workspace are persistent — they survive across chat sessions and are available to any agent assigned to that workspace.

### Uploading files

From the workspace edit panel, click the **Upload** button or drag and drop files directly into the Files section. Files generated during workspace chat sessions also appear here automatically.

<Frame caption="The Files section with drag-and-drop upload and the Upload button">
  <img src="https://mintcdn.com/creaoagent/L7jvWhXluKR0aaCS/images/workspaces-files.png?fit=max&auto=format&n=L7jvWhXluKR0aaCS&q=85&s=bab3ea47bcc166a44e8e48d6ea9b303d" alt="Workspace files section with upload area" width="1280" height="800" data-path="images/workspaces-files.png" />
</Frame>

### Supported file types

| Category      | Formats                         |
| ------------- | ------------------------------- |
| **Documents** | PDF, DOCX, XLSX, PPTX, CSV, TXT |
| **Images**    | PNG, JPEG, GIF, WebP, SVG       |
| **Code**      | JS, TS, PY, HTML, CSS, JSON     |
| **Archives**  | ZIP                             |

### How files are organized

Files in a workspace are displayed in two sections:

* **Images** — a visual grid of thumbnails for quick browsing. Click any image to open a full-size preview.
* **Documents** — a list view with file names, sizes, and upload dates. Click to download.

### Using workspace files in chat

When you start a conversation within a workspace context, the agent has access to all files in that workspace. You can reference them naturally:

```
Analyze the sales-data.csv file in this workspace and create a summary report
```

The agent will find the file in the workspace storage and process it.

## Adding agents to a workspace

Agents can belong to multiple workspaces simultaneously, making it easy to reuse the same agent across different projects.

<Steps>
  <Step title="Open the workspace">
    Click the workspace name in the sidebar to open its edit panel.
  </Step>

  <Step title="Click + Add">
    In the **Agents** section, click the **+ Add** button. A search picker appears showing all your available agents — including agents already assigned to other workspaces. Search by name or description to find the right one.

    <Frame caption="The Agents picker with search, result count, and agent descriptions">
      <img src="https://mintcdn.com/creaoagent/Ohbk40hL-HFSLDML/images/workspaces-add-app.png?fit=max&auto=format&n=Ohbk40hL-HFSLDML&q=85&s=ef9c84e26800e47123c3a6b5c85854f5" alt="Agents picker showing search input, agent count, and agent descriptions with add buttons" width="1280" height="800" data-path="images/workspaces-add-app.png" />
    </Frame>
  </Step>

  <Step title="Select an agent">
    Click the **+** icon next to an agent to add it to the workspace. The agent immediately appears in the workspace's Agents section.
  </Step>
</Steps>

### Removing an agent from a workspace

Click the **×** button on any agent card in the workspace to unassign it. The agent itself is not deleted — it remains available in any other workspaces it belongs to and can be reassigned later.

## Workspace in the sidebar

Active workspaces appear in the sidebar under the **Workspaces** section. Clicking a workspace name opens its edit panel. Below each workspace, you'll see:

* **Recent threads** — chat conversations that were started in the workspace context
* **Quick actions** — start a new chat within the workspace, or jump into the edit panel

This makes it easy to switch between projects without losing context.

## Managing workspaces

### Renaming a workspace

Open the workspace edit panel and edit the name directly in the **WORKSPACE NAME** field. Changes save automatically.

### Workspace colors

Each workspace gets a color indicator for quick visual identification in the sidebar and on cards. Colors are assigned automatically when you create the workspace.

<Tip>
  Use descriptive workspace names that reflect the project or client they represent — "Q1 Marketing Campaign", "Product Launch", "Client: Acme Corp".
</Tip>