Workspaces

Forjinn's Workspaces page allows you to organize projects, team members, and resources into isolated environments. Each workspace functions as a self-contained project space with its own chatflows, agentflows, credentials, and member roles.

Accessing Workspaces

1. From the left-hand sidebar, navigate to Admin or Settings.
2. Click on Workspaces to open the workspace management page.

What Is a Workspace?

A workspace is an isolated container for a team's resources within Forjinn. Each workspace has:

• Its own set of chatflows, agentflows, and tools.
• Independent credentials and variable configurations.
• A dedicated member list with role-based permissions.
• Separate execution logs and monitoring.

Workspaces are ideal for separating projects, environments (development, staging, production), or teams within an organization.

Creating a Workspace

1. On the Workspaces page, click Create Workspace or New Workspace.
2. Fill in the workspace details:
   • Name: A unique, descriptive name for the workspace.
   • Description: Optional context about the workspace's purpose.
   • Initial Members: Add yourself and invite other users who should have access.
3. Click Create to provision the workspace.

Managing Workspace Members

Each workspace has its own member list. As a workspace Owner or Admin, you can:

• Invite Members: Add users by email and assign them a role within the workspace.
• Change Roles: Promote or demote members between roles (e.g., Editor to Viewer).
• Remove Members: Revoke a user's access to the workspace.
• Set Default Role: Configure the role assigned to new members by default.

Workspace roles control what a member can do within that specific workspace but do not affect their access to other workspaces.

Switching Between Workspaces

To switch your active workspace:

1. Click on the workspace name or selector in the top-left sidebar.
2. Choose the workspace you want to switch to from the dropdown list.

All your resources — chatflows, agentflows, credentials, logs — are scoped to the currently selected workspace.

Workspace Settings

Each workspace can have its own configuration:

• Name and Description: Update identifying details.
• Default Model: Set the default LLM for new chatflows and agentflows within this workspace.
• Access Policy: Control whether workspace members can invite additional users.
• Resource Limits: In enterprise plans, set per-workspace limits on executions, storage, or concurrent runs.

Deleting a Workspace

1. Navigate to Workspace Settings.
2. Scroll to the Danger Zone section.
3. Click Delete Workspace.
4. Confirm the deletion.

Warning: Deleting a workspace permanently removes all associated chatflows, agentflows, credentials, logs, and variables. This action cannot be undone. Export important resources before deletion.

Best Practices

• Separate by environment: Use distinct workspaces for development, staging, and production to avoid cross-contamination.
• Separate by team: Give each team or project its own workspace for cleaner resource management and billing attribution.
• Limit ownership: Designate a small number of Owners per workspace to streamline governance.
• Document workspace purpose: Use the description field to clarify what each workspace is for, especially in large organizations.