Document Slack agent reconnect and one-org install

agent/slack.mdx

@@ -16,12 +16,22 @@
     <img src="/images/agent/install-apps-light.png" alt="The App settings section with the Slack and Notion install buttons." className="block dark:hidden" />
     <img src="/images/agent/install-apps-dark.png" alt="The App settings section with the Slack and Notion install buttons." className="hidden dark:block" />
   </Frame>
-3. Follow the Slack prompts to install the `mintlify` app in your workspace.
-4. Follow the Slack prompts to link your Mintlify account to your Slack workspace.
+3. Follow the Slack prompts to install the `mintlify` app in your workspace and grant the requested permissions.
+4. Confirm the connection in your Mintlify dashboard to your Slack workspace.
 5. Test that the agent is working and responds when you:
    - Send a direct message to the agent.
    - Mention the agent with `@mintlify` in a channel.
 
+<Note>
+  Each Slack workspace can connect to only one Mintlify organization at a time. If you try to install the agent into a workspace that is already connected to a different organization, the installation fails with a "wrong organization" error. Uninstall the app from the other organization first, or use a different Slack workspace.
+</Note>
+
+### Reconnect or reinstall the agent
+
+If you must reauthorize the agent—for example, to grant new permissions after a Slack scope update or to recover from a revoked token—reinstall the app from your Mintlify dashboard.
+
+When you reinstall the agent into a workspace that is already connected to your organization, Mintlify refreshes the stored bot token in place. You skip the binding confirmation step and your existing channels, threads, and per-user integrations remain intact.
+
 <Tip>
 If your organization has multiple deployments, the agent asks you to choose which deployment to work with the first time you send a request.
 
@@ -34,7 +44,7 @@
 
 ## Connect additional integrations from Slack
 
 After you connect your Slack workspace, you can ask the agent in Slack to set up any third-party integration that it should use as context. The agent uses [Composio](https://docs.composio.dev/toolkits) to support a broad catalog of third-party services, including issue trackers, knowledge bases, CRMs, and developer tools.
 
 To add a new integration from Slack:
 
@@ -71,7 +81,7 @@
 
 Example questions:
 - "Which pages mention the API rate limit?"
 - "How do I set up authentication?"
 - "How is our navigation structured?"
 
 ## Update documentation