Manage your workspaces

This guide shows you how to create workspaces, manage their members, and switch between projects.

For an overview of the role system, see Roles and permissions.

What workspaces are for

Workspaces isolate your data. Each workspace has its own:

• Conversations and traces - monitor issues separately per project
• Experiments - compare models without mixing results
• Issue configs - tailor detection to different use cases
• Team members - control who can access each project

Use separate workspaces when you need:

• Different environments (development, staging, production)
• Separate projects or clients
• Teams that shouldn't see each other's data

Create a workspace

1. Click Workspaces in the sidebar.
2. Click Create Workspace.
3. Enter a name for your workspace.
4. Edit the URL slug if needed. Blue Guardrails generates one from your name.
5. Click Create.

Your new workspace appears in the table.

Switch between workspaces

Use the workspace selector at the top of the sidebar.

1. Click the dropdown showing your current workspace name.
2. Select the workspace you want to switch to.

Blue Guardrails loads the new workspace's dashboard.

Add members to a workspace

You can add one or multiple members at a time. Only users who are already members of the organization can be added to a workspace.

1. Click Workspaces in the sidebar.
2. Click Manage Members on the workspace you want to manage.
3. Click Add Teammates.
4. Search for organization members by name or email.
5. Select a role for each member.
6. Click Add to invite them.

New members appear in the workspace members table immediately.

Change a member's role

1. Click Workspaces in the sidebar.
2. Click Manage Members on the workspace.
3. Find the member in the table.
4. Click the role dropdown next to their name.
5. Select the new role: Admin, Contributor, or Viewer.

Remove a member

1. Click Workspaces in the sidebar.
2. Click Manage Members on the workspace.
3. Find the member in the table.
4. Click the delete button on their row.
5. Confirm the removal in the dialog.

You cannot remove the last Admin from a workspace. Assign another member to Admin first if needed.

Use workspaces with the API

API keys belong to service accounts scoped to a single workspace. When you call the API, the key determines both the workspace and the permissions of the request. You don't need to pass a workspace ID alongside it.

To call the API for a different workspace, create a separate service account and key in that workspace. See Create an API key for your workspace for the full flow.