Setting Up Bridges
This guide walks you through creating a bridge between two workspaces, configuring permissions, and verifying the connection.
:::info Business or Enterprise Only Bridges require a Business or Enterprise plan. If you're on the Team plan, upgrade from Organization Settings → Plan Management before proceeding. :::
Prerequisites
Before creating a bridge, ensure:
- You have Admin or Owner role in your organization
- Both workspaces already exist
- Your organization is on a Business or Enterprise plan
Step 1: Navigate to the Bridges Page
From the Roundtable dashboard:
- Open the workspace you want to use as the bridge source.
- Click Bridges in the left sidebar navigation.
This opens the Bridge Panel, which lists all existing bridges for the current workspace.
Step 2: Create a Bridge
- Click Create Bridge in the top-right corner of the Bridge Panel.
- Select the target workspace from the dropdown. This lists all other workspaces in your organization.
- Give the bridge an optional description (e.g., "Engineering → Analytics for revenue queries").
- Click Create.
:::tip Naming Convention Use descriptive names that capture the relationship: "Eng → Analytics (data queries)" is far more useful than "Bridge 1" when you have multiple bridges. :::
Step 3: Set Permissions
After creating the bridge, configure what the source workspace is allowed to do:
| Permission | Description |
|---|---|
| Message | Source can send fire-and-forget messages to the target |
| Delegate | Source can invoke the target's AI and receive results |
You can enable one or both permissions:
- In the bridge detail view, find the Permissions section.
- Toggle Message, Delegate, or both.
- Click Save.
:::warning Permissions Are Directional Bridge permissions are one-way. If Workspace A has delegate permission to Workspace B, that does not mean B can delegate to A. To enable two-way communication, the target workspace must create a separate bridge back to the source, or an admin can configure bidirectional permissions. :::
Step 4: Verify Bridge Status
Each bridge displays a status indicator:
| Status | Meaning |
|---|---|
| Active | Bridge is ready to use. Both workspaces are accessible. |
| Inactive | Bridge exists but is disabled. No requests will be relayed. |
To verify your bridge is working:
- Check that the status shows Active in the Bridge Panel.
- From the source workspace chat, try a simple delegation:
@ai ask the [target workspace name] workspace to describe itself
- You should see the target workspace's AI respond with a description based on its system prompt.
Step 5: Confirm on Both Sides
Bridges are visible to both workspaces involved:
- Open the source workspace → Bridges panel → the bridge appears with outbound permissions listed.
- Open the target workspace → Bridges panel → the same bridge appears, showing it as an inbound connection.
This bidirectional visibility ensures both workspace teams are aware of the connection.
Managing Existing Bridges
Disable a Bridge
To temporarily stop communication without deleting the bridge:
- Open the bridge detail view.
- Toggle the status to Inactive.
- All requests through this bridge will be rejected until re-enabled.
Delete a Bridge
To permanently remove a bridge:
- Open the bridge detail view.
- Click Delete Bridge.
- Confirm the deletion.
:::danger Deleting Is Permanent Deleting a bridge removes it from both workspaces immediately. Any in-flight delegation requests will fail. You'll need to create a new bridge to restore the connection. :::
Next Steps
- Bridge Delegation — Learn how to delegate tasks across workspaces