> ## Documentation Index
> Fetch the complete documentation index at: https://slackhive.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-Workspace

> Connect agents across multiple Slack workspaces - all managed from a single SlackHive instance.

## One platform, many workspaces

SlackHive lets you deploy agents into multiple Slack workspaces from a single installation. Each agent carries its own Slack credentials, so agents in different workspaces run completely independently - while you manage everything from one dashboard.

Common setups:

| Setup                    | Example                                                        |
| ------------------------ | -------------------------------------------------------------- |
| **Single workspace**     | All agents live in `company.slack.com`                         |
| **Multi-team**           | Engineering agents in one workspace, support agents in another |
| **Client workspaces**    | Agency deploying agents into each client's Slack               |
| **Staging + production** | Same agent config, separate workspaces for testing             |

***

## How it works

Each agent stores its own Slack credentials:

* `slack_bot_token` - the bot's OAuth token (`xoxb-...`)
* `slack_app_token` - for Socket Mode (`xapp-...`)
* `slack_signing_secret` - to verify incoming events

When the runner starts, it creates a separate Slack Bolt connection for each agent using that agent's credentials. Agents in different workspaces don't share connections or interfere with each other.

***

## Setting up agents across workspaces

Each workspace needs its own Slack app. For each workspace:

<Steps>
  <Step title="Create a Slack app for that workspace">
    Create the agent in SlackHive, then open its **Overview** tab and generate a Slack app manifest. Install that manifest into the target workspace - **not** your main workspace.

    → See [Slack App Setup](/configuration/slack-app) for the full manifest install steps.
  </Step>

  <Step title="Collect the credentials">
    From the installed app, copy:

    * **Bot Token** (`xoxb-...`) - from OAuth & Permissions
    * **App Token** (`xapp-...`) - from Basic Information → App-Level Tokens
    * **Signing Secret** - from Basic Information

    These are workspace-specific. An app installed in workspace A cannot connect to workspace B.
  </Step>

  <Step title="Connect the agent in SlackHive">
    Paste the credentials into the agent's **Overview** tab. The runner will connect to that workspace automatically on the next start, or within seconds if already running.
  </Step>
</Steps>

Repeat for each workspace. You can have any number of agents per workspace.

***

## User management across workspaces

Users and roles in SlackHive are platform-wide - there's no per-workspace access control.

| What's shared           | What's isolated         |
| ----------------------- | ----------------------- |
| User accounts and roles | Agent Slack connections |
| Admin dashboard         | Agent memories          |
| Platform settings       | Agent skills and tools  |
|                         | Slack thread sessions   |

An admin can see and manage agents in all workspaces from the same dashboard. Use [per-agent access grants](/features/users#per-agent-access-grants) if you need to restrict editors to specific workspaces' agents.

***

## Boss agents across workspaces

A Boss and all its specialists **must be in the same Slack workspace**. Boss delegates by @mentioning specialists in the same thread - this only works when they share a workspace. If you need Boss orchestration in multiple workspaces, create a separate Boss and specialist set for each workspace.

***

## Next steps

<CardGroup cols={2}>
  <Card title="Slack App Setup" icon="slack" href="/configuration/slack-app">
    How to create and install a Slack app for each workspace.
  </Card>

  <Card title="Creating Agents" icon="robot" href="/agents/creating-agents">
    Create an agent with the two-step launch flow.
  </Card>
</CardGroup>