Skip to main content

Workspaces

Organize your data pipelines with isolated workspaces and control who has access to what.

Overview​

Workspaces provide complete isolation and governance within Supaflow. Each workspace has its own datasources, pipelines, projects, and schedules. This allows you to control access—for example, give only your SOC team access to production workspaces while development teams work in separate spaces.

Every resource (pipeline, datasource, project) belongs to exactly one workspace, ensuring clean separation and controlled access.

Key capabilities:

  • Create workspaces for different environments (dev, test, stage, prod)
  • Switch between workspaces easily
  • Share workspaces with team members
  • Control access with owner, editor, and viewer roles
  • Deploy configurations between workspaces

To access: Navigate to Workspaces in the sidebar.

Understanding Workspaces​

What is a Workspace?​

A workspace is an isolated environment for your data pipelines. Think of it like a project or environment where all your datasources, pipelines, and schedules live together.

Common workspace setups:

  • Separate workspaces for dev, staging, and production
  • One workspace per team (Marketing, Finance, Engineering)

Active Workspace​

The active workspace is the one you're currently working in. This determines what you see in the Pipelines, Sources, Destinations, and Activities pages.

You can see your current workspace in the top navigation bar with its environment badge.

Environment Labels​

Workspaces can be labeled with an environment type (dev, test, stage, uat, prod) for organization.

Note: Environment labels are for organization only - all workspaces have identical capabilities. The label just helps you visually identify the workspace's purpose.

Access Levels​

Workspaces have three access levels:

LevelWhat You Can Do
OwnerFull control - edit, share, delete workspace, manage all resources
EditorCreate and edit resources (pipelines, projects, datasources)
ViewerRead-only access to all resources

Creating a Workspace​

Who can do this: Organization admins only

To create:

  1. Go to Workspaces in the sidebar
  2. Click + Create Workspace (top right)
  3. Enter workspace details:
    • Workspace Name - Descriptive name (e.g., "Marketing Production")
    • API Name - Auto-generated lowercase identifier (can customize)
    • Description - Optional notes about the workspace's purpose
    • Environment - Choose dev, test, stage, uat, or prod
  4. Click Create Workspace

You'll be redirected to the Workspaces list where your new workspace appears.

Good naming examples:

  • "Marketing Production"
  • "Engineering Dev"
  • "Customer ABC - Prod"

Poor naming examples:

  • "Workspace 1"
  • "Test"
  • "New"

Switching Between Workspaces​

  1. Navigate to Workspaces in the sidebar
  2. Click the workspace card you want to enter
  3. The page refreshes showing that workspace's resources

The active workspace persists when you refresh the page or return to Supaflow later.

Best practice: Always verify the workspace badge in the top navigation before making changes.

Managing Workspaces​

Editing a Workspace​

Who can do this: Owners and Editors

To edit:

  1. Find the workspace card
  2. Click the three-dot menu (•••)
  3. Select Edit
  4. Update the name, API name, description, or environment
  5. Click Update Workspace

Note: Changing the API name may break existing API integrations.

Sharing a Workspace​

Who can do this: Owners only

To share:

  1. Find the workspace card
  2. Click the three-dot menu (•••)
  3. Select Share
  4. Enter team member's email address
  5. Select their access level:
    • Owner - For workspace administrators (1-2 people recommended)
    • Editor - For data engineers building pipelines
    • Viewer - For stakeholders, analysts, business users
  6. Click Send invitation

Managing access:

  • View all team members with access
  • Change someone's role
  • Remove someone's access

Best practice: Review workspace access quarterly and remove inactive users.

Deleting a Workspace​

Who can do this: Owners only

To delete:

  1. Find the workspace card
  2. Click the three-dot menu (•••)
  3. Select Delete
  4. Review what will be deleted (pipelines, projects, datasources, etc.)
  5. Type the workspace name to confirm
  6. Click Confirm Delete

⚠️ Important:

  • Deletion is permanent and cannot be undone
  • All resources are deleted (pipelines, datasources, projects, schedules)
  • Activity history is preserved for audit purposes

Common Workspace Patterns​

Pattern 1: Three-Tier Environment Setup​

Separate dev, stage, and prod workspaces for safe deployments.

Workflow:

Dev (build) → Stage (test) → Prod (deploy)

Pattern 2: Team-Based Workspaces​

Give each team their own workspace (Marketing, Finance, Engineering) for independent work with customized access controls.

Troubleshooting​

API Name Already Exists​

Problem: Can't create/edit workspace due to duplicate API name.

Solution: API names must be unique. Use a more specific name (e.g., marketing_dev instead of dev) or let the system auto-generate from your workspace name.

Best Practices​

  • Set appropriate access levels - Give Owner role to workspace admins only (1-2 people), Editor to data engineers, and Viewer to stakeholders
  • Use the description field - Document what the workspace is for and who owns it
  • Review access regularly - Remove users who left the team, downgrade access when responsibilities change
  • Deployments - Promote pipelines between workspaces
  • Projects - Organize pipelines within a workspace
  • Settings - Organization and workspace settings

Support​

Need help with workspaces? Contact us at support@supa-flow.io

Last updated on by pungaa
AI Tools
Ask ChatGPTClaudeAsk Claude
On this page