FlowTruxFlowTrux/Docs
Docsorganization

Workspaces

Organizing workflows and resources with workspaces.

A workspace is a logical grouping within an organization used to isolate workflows, resources, and access. Every workflow belongs to a workspace, and organization-level resources (AI providers, MCP servers, knowledge bases) are enabled per workspace.

The workspace is part of the URL: /workspaces/<workspace> is the workspace dashboard and /workspaces/<workspace>/workflows/<workflow> is the editor. This makes links shareable and switching workspaces a plain navigation - no reload.

Creating a Workspace

Owners and Admins can create workspaces:

  1. Click Create workspace - available in the left sidebar tree and on the organization dashboard header.
  2. Enter a name and an optional description.
  3. Save.

A default workspace is created automatically when an organization is set up. The number of workspaces depends on your plan.

Workspace Settings

Each workspace has its own settings page at /workspaces/<workspace>/settings (gear icon on the workspace in the sidebar tree), organized into four tabs:

TabWhat it contains
GeneralName, optional description, and workspace deletion.
Enabled resourcesWhich organization-level AI providers, MCP servers, and Knowledge Bases are available in this workspace.
MembersWhich MEMBER-role users have access, plus their workflow permissions (execute / create & edit / delete).
GlobalsWorkspace-scoped variables available in workflows via {{global.key}}. See Global Context.

Resource Assignment

AI providers, MCP servers, and knowledge bases are configured once at the organization level (on the Resources page) and then enabled per workspace:

  • When creating a resource, a workspace picker lets you choose where it should be available right away.
  • Later, use the workspace's Enabled resources tab to add or remove resources.

Only enabled resources appear in the workflow editor dropdowns (Agent node model selector, MCP Action node server selector, Knowledge Bases section, form trigger picker). If nothing is enabled for the current workspace, the editor shows a warning pointing you to the right settings.

Member Access

  • Owner and Admin roles automatically have access to all workspaces in the organization.
  • Member role users must be explicitly added to a workspace (workspace settings > Members tab) before they can see or interact with its workflows. Members not added to any workspace see no workflows.

Switching Workspaces

The left sidebar shows all workspaces you can access as a tree, with the organization at the top. Expanding a workspace lists its workflows; clicking anything navigates directly - the workflow list, resources, and global variables surfaced in the editor re-scope to the workspace in the URL.

The bare /workspaces landing page remembers the last workspace you visited and offers to continue there.

Deleting a Workspace

Owners and Admins can delete a workspace from its settings (General tab). Deleting a workspace removes all workflows, execution history, and global variables within it. This action cannot be undone.