Skip to main content

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:

  1. Open the workspace you want to use as the bridge source.
  2. 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

  1. Click Create Bridge in the top-right corner of the Bridge Panel.
  2. Select the target workspace from the dropdown. This lists all other workspaces in your organization.
  3. Give the bridge an optional description (e.g., "Engineering → Analytics for revenue queries").
  4. 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:

PermissionDescription
MessageSource can send fire-and-forget messages to the target
DelegateSource can invoke the target's AI and receive results

You can enable one or both permissions:

  1. In the bridge detail view, find the Permissions section.
  2. Toggle Message, Delegate, or both.
  3. 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:

StatusMeaning
ActiveBridge is ready to use. Both workspaces are accessible.
InactiveBridge exists but is disabled. No requests will be relayed.

To verify your bridge is working:

  1. Check that the status shows Active in the Bridge Panel.
  2. From the source workspace chat, try a simple delegation:
@ai ask the [target workspace name] workspace to describe itself
  1. 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:

  1. Open the bridge detail view.
  2. Toggle the status to Inactive.
  3. All requests through this bridge will be rejected until re-enabled.

Delete a Bridge

To permanently remove a bridge:

  1. Open the bridge detail view.
  2. Click Delete Bridge.
  3. 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