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

# Workspaces

> Organizational containers for flows and resources.

## Overview

A **workspace** is the primary organizational unit in whatabot. It groups all the resources needed to build and run conversational flows: flows, API keys, OAuth clients, AI agents, and sectors. Workspaces belong to an **account**, and a single account can have many workspaces, enabling multi-tenant separation of concerns.

## Workspace fields

| Field            | Type    | Description                                      |
| ---------------- | ------- | ------------------------------------------------ |
| `id`             | UUID v7 | Unique identifier, time-sortable                 |
| `name`           | string  | Display name for the workspace                   |
| `iframe_enabled` | boolean | Whether the workspace can be embedded via iframe |
| `timezone`       | string  | IANA timezone (default: `UTC`)                   |

<Callout type="info">
  The `timezone` field is used by the flow engine when formatting dates and
  times inside nodes (e.g., the `system.hour` variable). Make sure it matches
  your target audience's timezone.
</Callout>

## What belongs to a workspace

<CardGroup cols={2}>
  <Card title="Flows" icon="diagram-project">
    Conversational blueprints built in the visual editor. Each flow belongs to
    exactly one workspace.
  </Card>

  <Card title="API Keys" icon="key" href="/en/api-reference/authentication">
    Keys used to authenticate external systems when creating sessions and
    sending messages via the API.
  </Card>

  <Card title="OAuth Clients" icon="lock" href="/en/embed/authentication">
    Client credentials used for iframe embedding. Each client is scoped to a
    single workspace.
  </Card>

  <Card title="AI Agents" icon="robot">
    OpenAI agent configurations used by the OpenAI Agent node within flows.
  </Card>

  <Card title="Sectors" icon="building">
    Departments or teams that conversations can be transferred to via the
    Transfer node.
  </Card>
</CardGroup>

## Iframe embedding

Workspaces can enable or disable iframe embedding through the `iframe_enabled` flag. When enabled, external applications can embed the whatabot flow editor inside their own UI using an OAuth client scoped to that workspace.

<Callout type="tip">
  See the [Iframe Embedding](/en/embed/overview) guide for setup instructions
  and the [Embed Authentication](/en/embed/authentication) page for the
  authentication flow.
</Callout>