Workspaces: Organize Your Forjinn Projects
Workspaces are isolated environments for organizing flows, credentials, and team members. Create multiple workspaces to separate projects or teams.
Workspaces give you a clean way to separate your work inside Forjinn. Each workspace has its own flows, credentials, variables, document stores, and API keys — nothing leaks between them. You can create a workspace per team, per client, or per environment, and invite the right people to each one.
Create a workspace
You need the workspace:create permission to create workspaces.
In the left sidebar, go to Workspaces under the User & Workspace Management section.
Select New workspace in the top-right corner.
Enter a name for the workspace. Choose something that clearly identifies the project or team it belongs to.
Click Create. Your new workspace appears in the list immediately.
Switch between workspaces
You can belong to multiple workspaces. To switch, click the workspace name in the top navigation bar and select another workspace from the dropdown. The page reloads in the context of the selected workspace — all flows, credentials, and settings you see will be scoped to it.
You can switch to any workspace you have been invited to, regardless of your organization's plan tier.
Add members to a workspace
You need the workspace:add-user permission to add members.
Switch to the workspace you want to manage.
Navigate to Workspaces in the sidebar, then select the workspace from the list.
Select the Members tab on the workspace detail page.
Enter the email address or username of the person you want to add, choose their role for this workspace, and click Add.
A member's role within a workspace controls what they can do inside it. If you need fine-grained access control, create a custom role first — see Users & roles.
Remove members from a workspace
You need the workspace:unlink-user permission to remove members.
Follow the same steps as above to reach the Members tab for the workspace.
Find the person in the member list and click Remove. They lose access to the workspace immediately but their account is not deleted from your organization.
Import and export workspace data
Workspaces support bulk import and export of their contents, which is useful for backups, migrations, or duplicating a workspace setup.
Export
You need the workspace:export permission.
Navigate to the workspace detail page.
Select Export from the workspace actions menu. Forjinn downloads a JSON file containing the workspace's flows, credentials metadata, variables, and API key definitions.
Import
You need the workspace:import permission.
Navigate to the workspace where you want to import data.
Select Import, then choose the JSON file exported from another workspace.
Select how to handle conflicts:
- Add new only — skips items that already exist
- Overwrite if exists — replaces existing items with imported ones
- Replace all — deletes existing items first, then imports
Click Import to apply. Forjinn reports any errors for individual items without aborting the whole import.
Replace all permanently deletes the workspace's existing data before importing. Make sure you have a backup before choosing this mode.
Workspace permissions reference
The following permissions control what users can do with workspaces. Assign these through roles — see Users & roles.
| Permission | What it allows |
|---|---|
workspace:view | View workspaces you are a member of |
workspace:create | Create new workspaces |
workspace:update | Rename or edit workspace settings |
workspace:add-user | Add members to a workspace |
workspace:unlink-user | Remove members from a workspace |
workspace:delete | Delete a workspace and all its contents |
workspace:export | Export workspace data to a JSON file |
workspace:import | Import data into a workspace from a JSON file |
Deleting a workspace is permanent. All flows, credentials, variables, and API keys inside it are removed. Export a backup before deleting.
Delete a workspace
You need the workspace:delete permission.
Navigate to the workspace detail page.
Select Delete workspace from the workspace actions menu.
Type the workspace name to confirm, then click Delete. This action cannot be undone.
Permissions Reference
Complete reference of permission keys in Forjinn's role-based access control (RBAC) system.
Adding Credentials to Forjinn | API Keys & Authentication Setup
Learn how to securely add and manage API keys and credentials in Forjinn Visual AI Agent Builder. Connect to OpenAI, Anthropic, Google, and other AI services safely.