Workspaces

Workspaces let you partition your account into isolated environments. Each workspace has its own endpoints, API tokens, notification channels, Slack integrations, and members. This is useful for separating production from staging, or giving contractors access to a limited set of resources without exposing your entire account.

Business plans include 3 workspaces with add-on packs available. Pro plans use a single implicit workspace.

How workspaces differ from teams

Workspaces provide hard partitioning — resources in one workspace are invisible to users who only have access to another. Teams provide soft grouping within a workspace for organizing endpoints.

Creating a workspace

1. Go to Account Settings in the sidebar.
2. In the Workspaces section, enter a name and click Create Workspace.
3. You'll be redirected to the workspace management page.

Only account owners and admins can create workspaces.

Managing a workspace

Click Manage next to any workspace in Account Settings (or use the workspace switcher in the sidebar). From the management page you can:

• Rename — update the workspace name and description.
• Members — add or remove account users from the workspace with Admin or Viewer access.
• Notification channels — configure workspace-specific alerting destinations.
• Slack integrations — connect Slack workspaces scoped to this workspace.
• API tokens — generate workspace-scoped tokens that only access this workspace's resources.

Workspace members and roles

Workspace roles are intentionally simple:

Account admins and owners always have full access to all workspaces, regardless of workspace membership. Account members only gain workspace access through workspace assignment.

When you invite a new user to the account, they are automatically added to the default workspace. You can then add them to additional workspaces from each workspace's management page.

Switching workspaces

Use the workspace dropdown in the sidebar to switch between workspaces. The dropdown also provides quick links to Manage Workspace and All Workspaces (Account Settings) for users who can manage the current workspace.

Deleting a workspace

When you delete a workspace, all of its resources (endpoints, tokens, channels, etc.) are reassigned to another workspace. Workspace memberships are removed, so users who only had access through the deleted workspace will need to be added to the target workspace separately. If the deleted workspace had an active Slack integration and the target already has one, the moved integration is deactivated to avoid conflicts. You cannot delete the last workspace in an account.

API tokens and workspaces

API tokens can be scoped to either an account or a workspace:

CLI tokens (created during catchhook login) are always account-scoped.

Slack and workspaces

Slack App installs are now managed from each workspace's management page.

• Each CatchHook workspace can be connected to one Slack workspace.
• Reconnecting Slack for a workspace replaces that workspace's active Slack App install.
• Slack App installs are not capped separately at the account level; your workspace limit is the practical ceiling.

Workspace limits and add-ons

Pro users operate within a single default workspace. Upgrade to Business to unlock workspace management, multiple workspaces, and workspace-scoped API tokens.

Purchase add-on packs from the Workspaces section in Account Settings. Charges are prorated. See Billing & Plans for details.