ByteChef LogoByteChef
Automation
Enterprise Edition

Workspaces

Create and manage workspaces, the boundary that groups projects, connections, data tables, knowledge bases, and servers.

A workspace is the boundary a team works inside. Projects belong to a workspace, and so do the connections, data tables, knowledge bases, API keys, MCP servers, and A2A servers those projects use. Workspaces share nothing with each other, so they are the unit for separating teams, business units, or tenants.

Workspaces are administered from Settings → Workspaces in Automation (under Organization in the Settings sidebar). The page requires the organization admin authority. The workspace you are in is marked Current.

The Workspaces page, with a row's actions menu open

What a workspace scopes

Owned by the workspaceNotes
Projects and their deploymentsEvery project belongs to exactly one workspace.
ConnectionsShared across the workspace's projects rather than owned by one of them.
Data tablesWorkspace-scoped, so a lookup table is defined once and reused by every project. See Data Tables.
Knowledge basesWorkspace-scoped in the same way. See Knowledge Base.
API keysBound to the workspace and to an environment. See API Keys.
MCP servers and A2A serversBound to the workspace and to an environment. See MCP Servers and A2A Servers.
Members and their rolesManaged per workspace. The workspace Users page is coming soon; see Workspace Users.
Git configurationOne repository per workspace. See Git Configuration.
AI guardrails policyOne content policy per workspace (coming soon). See Guardrails.

All three environments exist inside every workspace. Environments are not a workspace-level choice, and you do not model them with workspaces.

Settings that are not workspace-scoped: identity providers, the license, and the organization user list are all instance-wide, and the encryption key protecting stored credentials is a single deployment-level key rather than one per workspace.

Create a workspace

  1. Go to Settings → Workspaces.
  2. Click New Workspace.
  3. Enter a Name and an optional Description.
  4. Click Save.

The new workspace starts empty.

Edit, manage members, or delete

Each row's ⋮ menu offers:

  • Edit - change the name and description.
  • Delete - remove the workspace after a confirmation. Deletion cannot be undone.

Coming soon

A Members entry on the same menu, opening a Workspace Members dialog, plus per-item gating on the workspace Admin and Viewer roles, are on the upcoming release track and are not yet available in the latest released version of ByteChef. Until then the whole page is gated on the organization admin authority and both menu items are open to whoever can reach it.

Workspace or project?

A project groups the workflows of one initiative and is the unit that gets published and deployed. A workspace groups projects and the shared state around them.

SituationReach for
Two teams that should not see each other's workSeparate workspaces
One team running several initiativesSeveral projects in one workspace
Each customer isolated in a multi-tenant deploymentOne workspace per tenant
Separating Development, Staging, and ProductionNeither; use environments
Onboarding an acquired teamA new workspace

Do not model stages as workspaces. Environments already exist inside every workspace, and versions are deployed per environment. Separate workspaces per stage lose that and require copying projects between workspaces by hand.

How is this guide?

Last updated on

On this page