Workspaces: Multi-Tenancy, Access Control, and Organization

InnoSynth-Forjinn's Workspaces feature enables true multi-tenancy, making it possible to isolate teams, projects, business units, or even customers while still leveraging platform power, analytics, and centralized administration.

What is a Workspace?

A Workspace is a distinct, logically separated environment within the platform:

Each workspace has its own chatflows, agents, datasets, credentials, and settings.
User Permissions: Users can be members of one or many workspaces, with roles (Admin, Developer, Viewer) set per workspace.
Data Isolation: Data (flows, queries, logs) in one workspace are not visible to another unless explicitly shared.

Creating and Managing Workspaces

Via UI

Navigate: Go to Settings → Workspaces.
Create Workspace: Click New Workspace, then set a name, description, and (optionally) color/icon.
Add/Remove Users: In the workspace settings, invite users by email, assign roles, and group memberships.
Switch Workspaces: Use workspace selector at the top or sidebar to quickly switch context—your view, flows, and agent lists update.

Via API

Create: POST /api/v1/workspace (name, description)
Add User: POST /api/v1/workspace/<id>/add-user (userId, role)
Remove User: POST /api/v1/workspace/<id>/remove-user
List: GET /api/v1/workspaces
Switch: POST /api/v1/auth/switch-workspace

Use Cases and Best Practice Patterns

Enterprise: Separate divisions (R&D, Sales, Support) into workspaces, granting access only to their own data and agents.
Consultancy/Agency: Assign a workspace per client; manage different secrets, workflows, and billing in one platform.
Testing & Production: Distinct dev/staging/prod workspaces for robust change control and safe deployments.
Data Science Team: Use a separate workspace for dataset curation, with strict member-only access.

Data Sharing, Cloning, and Migration

Share Flows/Agents: (If enabled) Export from one workspace, import into another. (Direct sharing features to be released.)
Clone Datasets: Use import/export tools or platform API to copy data/metadata.
Bulk Admin Tools: Admin can batch move or copy flows among workspaces with proper authority.

Managing Access & Roles

Role Levels: Admin, Developer, Viewer (configurable)
Per-Workspace Invitations: Inviting a user to a workspace does not give them access to others.
Auditing: Admins can view access logs, role changes, and workspace-specific activity records.

Troubleshooting/Common Issues

"I can't see my workflow/agent": Check you are in the correct workspace.
User can't access dataset/credential: Ensure they're a member of the workspace and that permissions are correct.
Cannot change workspace/global settings: Only workspace admins (or global platform admins) can do so.

Workspaces make InnoSynth-Forjinn a fit for scaling across teams, clients, and even many independent business lines—securely and efficiently.

Forjinn Docs

Workspaces