Skip to main content
CadreenResearch Preview
DocumentationAPI ReferenceGuides & Cookbooks
Back to Guides & Cookbooks
Cookbook

Connect Two Workspaces

A step-by-step walkthrough. You'll initiate a link, review consent, approve it, link agents, and manage the connection. Takes about 5 minutes (plus approval time).

Prerequisites

  • — A Cadreen workspace (your own)
  • — The target workspace ID (from the other team)
  • — Agreement on what to share

What you'll do

Five steps. Click each one to see what happens.

InitiateYou create a linkConsentThey reviewLinkConnect agentsManageMonitor & suspendRevokePermanent end
1

Initiate a link

You decide to connect your workspace to another. You specify which workspace and what permissions you want to share.

Go to Federation and click Link workspace. Enter the target workspace ID and choose what to share.

The other workspace will see a pending request. Nothing happens until they approve.

POST/api/v1/cadreen/federation
2

Review the consent screen

Before approving, you see exactly what the remote agent will access. What's shared. What's not. The consequences.

The consent screen shows you a matrix of permissions — what the partner can see, what they can't, and what requires your approval each time.

Visible to partner
  • ✓ Knowledge with federation visibility
  • ✓ Capabilities you choose to share
Never shared
  • ✗ Private policies
  • ✗ API keys
  • ✗ Execution history (unless enabled)
Note
You can approve, decline, or cancel. If you decline, the link is dissolved. If you approve, the link becomes active and agents can communicate.
POST/api/v1/cadreen/federation/{id}/approve
3

Link agents

Once the federation link is active, tell the system which agents can talk to each other across workspaces.

Linking agents is explicit. You choose which of your agents connects to which of their agents. This isn't automatic — you decide.

Go to the federation link in the dashboard, click Link agents, and select the agents on each side.

POST/api/v1/cadreen/federation/{id}/agents
4

Manage the link

See the status, expand linked agents, suspend or revoke. You're always in control.

The federation dashboard shows all your links, grouped by status. Click any link to see details — which agents are connected, what permissions are active, and the full history of interactions.

You can suspend a link anytime. This pauses communication without destroying the connection. Re-activate when you're ready.

GET/api/v1/cadreen/federation
5

Revoke when done

When the partnership ends, revoke the link. This is permanent. The connection is dissolved and cannot be undone.

Revoke is permanent. The link is dissolved, agents can no longer communicate across workspaces, and the full history is preserved in the audit log.

Revocation cannot be undone

If you need to reconnect, you'll have to create a new federation link and go through the consent process again.

To revoke, go to the federation link in the dashboard and click Revoke. You'll be asked to confirm.

POST/api/v1/cadreen/federation/{id}/revoke

What you built

You now have a governed federation link. Your agents can communicate across workspaces — with permission, with oversight, and with a full audit trail. You can suspend or revoke anytime.

Security built in

  • — Cross-tenant federation is blocked at the database level
  • — Row-level security on all federation tables
  • — Bidirectional ownership checks
  • — Full audit trail of every interaction
  • — Either side can suspend or revoke anytime

Next steps