Skip to content

docs(agent): note Enterprise Grid workspace install for Slack app #6077

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
skeptrunedev merged 1 commit into from
Jun 4, 2026
+6 −0
Merged

docs(agent): note Enterprise Grid workspace install for Slack app #6077

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions agent/slack.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,15 @@
<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.

You can install the Slack agent even if you don't have a Mintlify-hosted deployment. The agent still works for question answering and conversations; features that open pull requests require a connected repository.

Check warning on line 28 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L28 

Use semicolons judiciously.
</Note>

<Warning>
On Slack Enterprise Grid, installing the app to your organization is not enough. You must also install it to the specific workspace where you want to use the agent. If you skip this step, the agent appears available at the org level but does not respond in your workspace.

To add the app to a workspace, open your org's app management page at a URL like `https://app.slack.com/manage/<your-org-id>/integrations/installed`, find the `mintlify` app, and install it to your workspace.
</Warning>

### 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.
Expand Down Expand Up @@ -63,7 +69,7 @@

Example questions:
- "Which pages mention the API rate limit?"
- "How do I set up authentication?"

Check warning on line 72 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L72 

Avoid first-person pronouns such as ' I '.
- "How is our navigation structured?"

## Update documentation
Expand Down
Loading