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.

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.
1

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.
2

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.
3

Choose a role

Pick the role they should have in this workspace.
4

Add them

Click Add. They are added as active members immediately and notified that they now have access.

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.
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.

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