Workspaces

Overview

Workspaces are collaborative environments that help you organize your tools, resources, and team members. Each workspace provides an isolated environment for your projects, allowing you to manage access controls, assign tools, and coordinate with your team.

Creating a workspace

To create a new workspace:

Navigate to the Workspaces page from your dashboard
Click the Create Workspace button in the top-right corner
Fill in the workspace details:
- Name (required): Choose a descriptive name for your workspace
- Description (optional): Add context about the workspace’s purpose
Click Create to complete the process

Use descriptive names and descriptions to help team members quickly understand each workspace’s purpose.

Workspace features

Members

Invite team members to your workspace to collaborate on projects. Each workspace displays the total number of members and allows you to manage access permissions.

Tools

Assign tools to your workspace to make them available for your team. The workspace dashboard shows the total number of tools configured and ready to use.

Permissions

Workspaces support role-based access control:

workspace:delete - Allows users to delete the workspace
Additional permissions can be configured based on your organization’s needs

Only users with the appropriate permissions can delete workspaces. This helps prevent accidental data loss.

Managing workspaces

Viewing workspaces

The Workspaces page displays all workspaces you have access to in a grid layout, showing:

Workspace name and description
Number of members
Number of configured tools
Last updated timestamp

Desktop view

The desktop layout shows workspaces in a 3-column grid for optimal viewing on large screens.

Tablet view

On tablets, the layout adapts to a 2-column grid for better readability.

Mobile view

Mobile workspace view with single column

Mobile devices display workspaces in a single column for easy scrolling and interaction.

Empty state

Empty workspace state with create button

When you don’t have any workspaces yet, you’ll see a helpful empty state with a prominent create button.

Deleting a workspace

If you have the workspace:delete permission:

Locate the workspace you want to delete
Click the trash icon in the workspace card
Confirm the deletion when prompted

Deleting a workspace is permanent and cannot be undone. Ensure you have backed up any important data before proceeding.

Best practices

Organize by project

Create separate workspaces for different projects or teams to keep resources organized.

Use descriptive names

Choose clear, descriptive names that make it easy to identify each workspace’s purpose.

Manage permissions carefully

Assign appropriate permissions to team members based on their roles and responsibilities.

Regular cleanup

Periodically review and remove unused workspaces to keep your organization tidy.

Documentation

Overview

Creating a workspace