diff --git a/agent/slack.mdx b/agent/slack.mdx
index cdba8e12d..0b956495b 100644
--- a/agent/slack.mdx
+++ b/agent/slack.mdx
@@ -16,12 +16,22 @@ keywords: ["Slack integration", "Slack bot", "team collaboration", "agent integr
     <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. 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.