Skip to main content
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

1

Open Workspaces

Go to Settings > Workspaces in the top-level organization.
2

Click Create workspace

Click Create workspace.
3

Enter a name

Enter a workspace name, such as Internal Support or EMEA Support.
4

Create the workspace

Click Create. Duckie creates the workspace and adds you as an admin.
5

Switch into the workspace

Click Switch from the confirmation toast, or click Manage from the workspace list.
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.

​
What is isolated

Each workspace is an isolated Duckie environment. Workspace-specific data includes:
AreaWhat is scoped to the workspace
Members and rolesWorkspace membership and role assignments
ConnectionsConnected integrations and credentials
Agents and deploymentsAgent configuration, deployment settings, and production runs
Knowledge and trainingKnowledge items, guidelines, guardrails, runbooks, snippets, tools, and workflows
Analytics and testingRuns, 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

Deleting a workspace is permanent. It deletes the workspace and its data, including members, agents, runs, knowledge, and connections.
To delete a workspace:
1

Open Workspaces

Go to Settings > Workspaces in the top-level organization.
2

Choose the workspace

Find the workspace in the list.
3

Click delete

Click the delete icon on the workspace row.
4

Confirm deletion

Review the warning and confirm the deletion.
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

Organization Settings

Manage organization-level details and billing

Team Members

Manage workspace members and roles