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

# Workspaces

> Create and manage isolated Duckie workspaces under your organization

Workspaces let you split one Duckie organization into separate areas for different teams, products, regions, or support motions. Each workspace has its own configuration and data, while billing rolls up to the top-level organization.

Use workspaces when different groups need separate agents, knowledge, connections, members, roles, runs, or settings.

## Who can manage workspaces

You can manage workspaces when:

* You are in the top-level organization, not already inside a workspace
* You are an admin
* Your role has the workspace management permission

If you do not see **Workspaces** in Settings, switch back to the top-level organization or ask an admin to update your role.

## Open Workspaces

Go to **Settings > Workspaces**.

The page lists the workspaces under the current top-level organization. Each row shows the workspace name, when it was created, and actions to manage or delete it.

## Create a workspace

<Steps>
  <Step title="Open Workspaces">
    Go to **Settings > Workspaces** in the top-level organization.
  </Step>

  <Step title="Click Create workspace">
    Click **Create workspace**.
  </Step>

  <Step title="Enter a name">
    Enter a workspace name, such as `Internal Support` or `EMEA Support`.
  </Step>

  <Step title="Create the workspace">
    Click **Create**. Duckie creates the workspace and adds you as an admin.
  </Step>

  <Step title="Switch into the workspace">
    Click **Switch** from the confirmation toast, or click **Manage** from the workspace list.
  </Step>
</Steps>

After you switch, the dashboard reloads under that workspace. Configure its members, connections, agents, knowledge, guidelines, guardrails, tools, deployments, testing, and analytics from the workspace context.

## Switch between organizations and workspaces

If you belong to more than one organization or workspace, Duckie shows an organization switcher in the top bar.

The switcher groups top-level organizations under **Organizations** and workspaces under **Workspaces**. Choose a workspace to make it active. Duckie refreshes the page so pages and data are scoped to the selected workspace.

You can also click **Manage** from **Settings > Workspaces** to switch directly into a workspace.

## Add members to a workspace

Members are added per workspace — being in one workspace never grants access to another. There are two ways to add someone, and a person only ever needs to be invited to Duckie once.

### Add existing members from your organization

If someone is already in your top-level organization or another workspace under it, you can add them to a workspace directly. There is no email invitation to send or accept — they get access right away.

<Steps>
  <Step title="Open the add-members dialog">
    From **Settings > Workspaces** in the top-level organization, click **Add members** on the workspace you want. Inside a workspace, you can also use **Add from your organization** on **Settings > Members**.
  </Step>

  <Step title="Pick the people to add">
    Search by name or email and select one or more existing members. Anyone already in the workspace is left out of the list.
  </Step>

  <Step title="Choose a role">
    Pick the role they should have in this workspace.
  </Step>

  <Step title="Add them">
    Click **Add**. They are added as active members immediately and notified that they now have access.
  </Step>
</Steps>

### Invite someone new

For a person who isn't in your organization yet, invite them by email from the workspace's **Settings > Members** page. They get access to that workspace only.

<Note>
  If the email already belongs to someone in your organization, Duckie adds them to the workspace directly instead of sending another invitation — so nobody is invited to Duckie twice.
</Note>

## What is isolated

Each workspace is an isolated Duckie environment. Workspace-specific data includes:

| Area                   | What is scoped to the workspace                                                   |
| ---------------------- | --------------------------------------------------------------------------------- |
| Members and roles      | Workspace membership and role assignments                                         |
| Connections            | Connected integrations and credentials                                            |
| Agents and deployments | Agent configuration, deployment settings, and production runs                     |
| Knowledge and training | Knowledge items, guidelines, guardrails, runbooks, snippets, tools, and workflows |
| Analytics and testing  | Runs, usage attribution, playground activity, and batch tests                     |

Changing one workspace does not change a sibling workspace.

## Billing and usage

Workspaces do not have separate billing plans. Their usage rolls up to the top-level organization's plan.

When you view usage from the top-level organization, Duckie includes usage from the top-level organization and its workspaces. If workspaces exist, the Usage page also shows **Usage by workspace** so you can see how billable usage is distributed.

When you are active inside a workspace, the Usage settings page is hidden.

## Delete a workspace

<Warning>
  Deleting a workspace is permanent. It deletes the workspace and its data, including members, agents, runs, knowledge, and connections.
</Warning>

To delete a workspace:

<Steps>
  <Step title="Open Workspaces">
    Go to **Settings > Workspaces** in the top-level organization.
  </Step>

  <Step title="Choose the workspace">
    Find the workspace in the list.
  </Step>

  <Step title="Click delete">
    Click the delete icon on the workspace row.
  </Step>

  <Step title="Confirm deletion">
    Review the warning and confirm the deletion.
  </Step>
</Steps>

Delete only workspaces you no longer need. Deleted workspace data cannot be restored.

## Constraints

* Workspaces can only be created under a top-level organization.
* Workspaces cannot contain nested workspaces.
* Workspace billing always rolls up to the top-level organization.
* A top-level organization cannot be deleted until its workspaces are deleted.

## Next Steps

<CardGroup cols={2}>
  <Card title="Organization Settings" icon="building" href="/settings/organization">
    Manage organization-level details and billing
  </Card>

  <Card title="Team Members" icon="users" href="/settings/members">
    Manage workspace members and roles
  </Card>
</CardGroup>