From 1cb2a0bafe08faa2c15ece391ce23edda4be3181 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 11 Nov 2026 19:25:46 +0000 Subject: [PATCH 1/5] docs: document connecting Slack from the Integrations page --- agent/slack.mdx | 4 ++++ automations/integrations.mdx | 4 +++- mint-instructions/automate.mdx | 2 +- 3 files changed, 8 insertions(+), 2 deletions(-) diff --git a/agent/slack.mdx b/agent/slack.mdx index b9cb28b68c..46baa58b31 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -34,6 +34,8 @@ The Slack agent runs on [Autopilot](/autopilot). When Autopilot posts in a Slack - Send it a message in its **Chat** tab. - Mention the agent with `@mintlify` in a channel. +On Enterprise plans, you can also connect Slack from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard settings. Find **Slack** and click **Connect**. + On Slack Enterprise Grid, you must install the app to the specific workspace where you want to use the agent. If you skip this step, the agent appears available at the organization level but does not respond in your workspace. @@ -56,6 +58,8 @@ To remove the agent from your Slack workspace: 4. In Slack, navigate to **Manage apps**. 5. Click **Remove** on the Mintlify app. +On Enterprise plans, you can also disconnect from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page. Click **Configure** on Slack, then click **Disconnect** and confirm. + When you disconnect the Slack app, the agent stops responding to mentions and direct messages, and automations that post to Slack stop delivering notifications. ### Reconnect or reinstall the agent diff --git a/automations/integrations.mdx b/automations/integrations.mdx index a2cab1116c..beac635a95 100644 --- a/automations/integrations.mdx +++ b/automations/integrations.mdx @@ -18,7 +18,7 @@ Integrations connect the Mintlify agent to other tools your team uses. The agent | **Automation trigger** | Starts a custom automation when a selected event occurs in a supported shared integration or when a new message posts to a selected Slack channel. | - The [Mintlify Slack app](/agent/slack) is separate from the third-party integrations on this page. Installing the Slack app adds the agent to your workspace and gives it read access to Slack content. You do not connect Slack from the **Integrations** settings page or select it in an automation's **Integrations** field. After you install the Slack app, you can select Slack as a custom automation trigger and the [editor agent](/editor/agent#read-your-slack-workspace) can read your workspace for context. + The [Mintlify Slack app](/agent/slack) works differently from the third-party integrations on this page. Installing the Slack app adds the agent to your workspace and gives it read access to Slack content. You can install it from the **Integrations** settings page, but you cannot select Slack in an automation's **Integrations** field. After you install the Slack app, you can select Slack as a custom automation trigger and the [editor agent](/editor/agent#read-your-slack-workspace) can read your workspace for context. ## Connection scope @@ -157,6 +157,8 @@ Disconnecting a shared integration removes it for everyone in your organization. Disconnecting a personal integration only removes your connection. Other teammates keep their personal connections. +To disconnect Slack, click **Configure** on Slack, then click **Disconnect** and confirm. Disconnecting Slack removes the Mintlify Slack app for every Mintlify product that uses it, including the Slack agent and automations. + ## Troubleshoot a connection If an integration stops working: diff --git a/mint-instructions/automate.mdx b/mint-instructions/automate.mdx index 6f90375c86..ea499c646a 100644 --- a/mint-instructions/automate.mdx +++ b/mint-instructions/automate.mdx @@ -24,7 +24,7 @@ Use this to keep docs current or check them on every pull request. Most setup is 5. Automations: the user creates and manages them on the **Automations** page of the dashboard. Help them choose a name, trigger, and prompt. Prompts: one task, numbered steps, exact paths, done state. 6. Test: user clicks **Test run** / **Run now** and picks a scope (**Since a date**, **Everything**, **Specific pull request**). Not available for Integration or Webhook triggers. Check the **Runs** tab. 7. Autopilot: user opens https://app.mintlify.com/products/autopilot, switches on the toggle, picks **Additional repositories** under GitHub **Configure** (GitLab: **Additional projects**, after connecting projects through GitLab OAuth in Git settings. Azure Repos: **Configure** in the **Azure Repos** row), and uses **Chat to configure** to change reviewers, target branch, or schedule. -8. Slack agent: user clicks **Connect Slack** on the Automations page and installs the `mintlify` app (workspace admin approval may be needed; on Enterprise Grid install to the specific workspace). Test with a DM or `@mintlify` in a channel. The Slack agent also chats with Autopilot: ask about its work or change what it works on. Not available for Bitbucket Cloud projects. +8. Slack agent: user clicks **Connect Slack** on the Automations page (Enterprise: or **Connect** on Slack in organization Integrations settings) and installs the `mintlify` app (workspace admin approval may be needed; on Enterprise Grid install to the specific workspace). Test with a DM or `@mintlify` in a channel. The Slack agent also chats with Autopilot: ask about its work or change what it works on. Not available for Bitbucket Cloud projects. ## What each piece does From cf330e811f56245f28caf4041fe2ef51cdee62a0 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 11 Nov 2026 16:42:20 -0800 Subject: [PATCH 2/5] docs: tie Slack Integrations paths to the existing steps The Integrations page Disconnect revokes the token but doesn't uninstall the app from Slack, so readers still need the Manage apps steps. Point both alternate paths back to the step they rejoin, link the integrations page to the Slack disconnect steps instead of duplicating them, and clarify the automate instructions. Co-Authored-By: Claude Opus 5.5 --- agent/slack.mdx | 4 ++-- automations/integrations.mdx | 2 +- mint-instructions/automate.mdx | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/agent/slack.mdx b/agent/slack.mdx index 46baa58b31..b8667a6d2e 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -34,7 +34,7 @@ The Slack agent runs on [Autopilot](/autopilot). When Autopilot posts in a Slack - Send it a message in its **Chat** tab. - Mention the agent with `@mintlify` in a channel. -On Enterprise plans, you can also connect Slack from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard settings. Find **Slack** and click **Connect**. +On Enterprise plans, you can start from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard settings instead. Click **Connect** next to Slack, then continue from step 3. On Slack Enterprise Grid, you must install the app to the specific workspace where you want to use the agent. If you skip this step, the agent appears available at the organization level but does not respond in your workspace. @@ -58,7 +58,7 @@ To remove the agent from your Slack workspace: 4. In Slack, navigate to **Manage apps**. 5. Click **Remove** on the Mintlify app. -On Enterprise plans, you can also disconnect from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page. Click **Configure** on Slack, then click **Disconnect** and confirm. +On Enterprise plans, you can start from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page instead. Click **Configure** next to Slack, click **Disconnect** and confirm, then continue from step 4. When you disconnect the Slack app, the agent stops responding to mentions and direct messages, and automations that post to Slack stop delivering notifications. diff --git a/automations/integrations.mdx b/automations/integrations.mdx index beac635a95..3440e30350 100644 --- a/automations/integrations.mdx +++ b/automations/integrations.mdx @@ -157,7 +157,7 @@ Disconnecting a shared integration removes it for everyone in your organization. Disconnecting a personal integration only removes your connection. Other teammates keep their personal connections. -To disconnect Slack, click **Configure** on Slack, then click **Disconnect** and confirm. Disconnecting Slack removes the Mintlify Slack app for every Mintlify product that uses it, including the Slack agent and automations. +To disconnect Slack, see [Disconnect the agent](/agent/slack#disconnect-the-agent). ## Troubleshoot a connection diff --git a/mint-instructions/automate.mdx b/mint-instructions/automate.mdx index ea499c646a..fd9b2a7e8f 100644 --- a/mint-instructions/automate.mdx +++ b/mint-instructions/automate.mdx @@ -24,7 +24,7 @@ Use this to keep docs current or check them on every pull request. Most setup is 5. Automations: the user creates and manages them on the **Automations** page of the dashboard. Help them choose a name, trigger, and prompt. Prompts: one task, numbered steps, exact paths, done state. 6. Test: user clicks **Test run** / **Run now** and picks a scope (**Since a date**, **Everything**, **Specific pull request**). Not available for Integration or Webhook triggers. Check the **Runs** tab. 7. Autopilot: user opens https://app.mintlify.com/products/autopilot, switches on the toggle, picks **Additional repositories** under GitHub **Configure** (GitLab: **Additional projects**, after connecting projects through GitLab OAuth in Git settings. Azure Repos: **Configure** in the **Azure Repos** row), and uses **Chat to configure** to change reviewers, target branch, or schedule. -8. Slack agent: user clicks **Connect Slack** on the Automations page (Enterprise: or **Connect** on Slack in organization Integrations settings) and installs the `mintlify` app (workspace admin approval may be needed; on Enterprise Grid install to the specific workspace). Test with a DM or `@mintlify` in a channel. The Slack agent also chats with Autopilot: ask about its work or change what it works on. Not available for Bitbucket Cloud projects. +8. Slack agent: user clicks **Connect Slack** on the Automations page (on Enterprise, they can instead click **Connect** next to Slack on the organization **Integrations** settings page) and installs the `mintlify` app (workspace admin approval may be needed; on Enterprise Grid install to the specific workspace). Test with a DM or `@mintlify` in a channel. The Slack agent also chats with Autopilot: ask about its work or change what it works on. Not available for Bitbucket Cloud projects. ## What each piece does From 4acf0f7aec5c73a6153113c2c3f7e2438693b06a Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 11 Nov 2026 16:44:10 -0800 Subject: [PATCH 3/5] docs: tidy the Slack agent connect section Merge the Bitbucket and IP allowlist note into the prerequisites note so callouts aren't back-to-back, and cut the confirm step: the /slack/connect page binds the workspace on its own and only shows a button on failure. Co-Authored-By: Claude Opus 5.5 --- agent/slack.mdx | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/agent/slack.mdx b/agent/slack.mdx index b8667a6d2e..971d3f5f2c 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -19,18 +19,21 @@ The Slack agent runs on [Autopilot](/autopilot). When Autopilot posts in a Slack ## Connect your Slack workspace + The Slack agent is not available for [Bitbucket Cloud](/deploy/bitbucket) projects. + If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the Mintlify app before you connect it. 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. You can install the Slack agent even if you don't have a Mintlify-hosted project. The agent still works for question answering and conversations. Features that open pull requests require a connected repository. + + If your Git provider is behind an IP allowlist, allow the Mintlify egress IP `54.242.90.151` so the agent can clone your repository. Contact support to opt in. 1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings. 2. Click **Connect Slack**. 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: +4. Test that the agent responds when you: - Send it a message in its **Chat** tab. - Mention the agent with `@mintlify` in a channel. @@ -42,12 +45,6 @@ On Enterprise plans, you can start from the [Integrations](https://app.mintlify. To add the app to a workspace, open your organization's app management page (a URL like `https://app.slack.com/manage//integrations/installed`). Find the `mintlify` app and install it to your workspace. - - The Slack agent is not available for [Bitbucket Cloud](/deploy/bitbucket) projects. - - If your Git provider is behind an IP allowlist, allow the Mintlify egress IP `54.242.90.151` so the agent can clone your repository. Contact support to opt in. - - ### Disconnect the agent To remove the agent from your Slack workspace: From addf50a97bbf2daeb9d08e15470530fd7a968983 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 11 Nov 2026 16:49:37 -0800 Subject: [PATCH 4/5] Update agent/slack.mdx --- agent/slack.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/agent/slack.mdx b/agent/slack.mdx index 971d3f5f2c..68c864e15f 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -37,7 +37,9 @@ The Slack agent runs on [Autopilot](/autopilot). When Autopilot posts in a Slack - Send it a message in its **Chat** tab. - Mention the agent with `@mintlify` in a channel. -On Enterprise plans, you can start from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard settings instead. Click **Connect** next to Slack, then continue from step 3. + + On Enterprise plans, you can start from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard settings instead. Click **Connect** next to Slack, then continue from step 3. + On Slack Enterprise Grid, you must install the app to the specific workspace where you want to use the agent. If you skip this step, the agent appears available at the organization level but does not respond in your workspace. From fea9a9227c1184a50f1c2686eb6bbf9cfaf0a755 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Wed, 11 Nov 2026 16:50:04 -0800 Subject: [PATCH 5/5] Apply suggestion from @ethanpalm --- agent/slack.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/agent/slack.mdx b/agent/slack.mdx index 68c864e15f..3c01f0ec21 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -57,7 +57,9 @@ To remove the agent from your Slack workspace: 4. In Slack, navigate to **Manage apps**. 5. Click **Remove** on the Mintlify app. -On Enterprise plans, you can start from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page instead. Click **Configure** next to Slack, click **Disconnect** and confirm, then continue from step 4. + + On Enterprise plans, you can start from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page instead. Click **Configure** next to Slack, click **Disconnect** and confirm, then continue from step 4. + When you disconnect the Slack app, the agent stops responding to mentions and direct messages, and automations that post to Slack stop delivering notifications.