mintlify · andrew-mintlify-cs · May 5, 2026 · May 5, 2026 · May 5, 2026 · May 5, 2026
diff --git a/.gitignore b/.gitignore
@@ -3,3 +3,4 @@ node_modules
 package-lock.json
 .idea/
 .vscode/
+.pr-body.md
diff --git a/.vale/styles/config/vocabularies/Mintlify/accept.txt b/.vale/styles/config/vocabularies/Mintlify/accept.txt
@@ -5,11 +5,14 @@ ACS
 Adobe
 AEO
 agentic
+AGENTS
 Ahrefs
 AI
+allOf
 allowlists?
 AllViewerExceptHostHeader
 Anthropic
+anyOf
 API
 apiHost
 apiKey
@@ -30,6 +33,7 @@ autofocus(es)?
 automations?
 (?i)automerge
 (?i)autoplay
+autosave(s|d)?
 autoupdate
 AVIF
 await
@@ -52,8 +56,9 @@ CAA
 CachingDisabled
 CachingEnabled
 CachingOptimized
-(?i)captchas?
+Caddy
 callouts?
+(?i)captchas?
 camelCase
 Cascade
 CD
@@ -96,6 +101,7 @@ ctx
 Cursor
 cURL
 customizability
+Datadog
 debounce[ds]?
 (?i)deduplic(ated?|ation)
 desc
@@ -107,6 +113,7 @@ dir
 Di(?:á|a)taxis
 Discord
 discoverability
+discoverable
 dismissible
 Django
 DMs?
@@ -159,9 +166,11 @@ GitHub
 GitLab
 Golang
 GraphQL
+gRPC
 Grok
 GTM
 gui
+hardcod(e[ds]?|ing)
 hCaptcha
 headless
 (?i)heatmaps?
@@ -180,6 +189,7 @@ HubSpot
 ICO
 IDE
 IdP
+idempoten(t|cy|ce)
 IDs
 iframes?
 Imgix
@@ -235,7 +245,7 @@ macOS
 md
 MDX
 measurementId
-(?i)Memoize
+(?i)memoiz(e[ds]?|ation)
 Mermaid
 (?i)metadata
 metatags?
@@ -254,11 +264,13 @@ mvc
 myName
 myObject
 MySQL
+namespaces?
 nav
 (?i)navbar
 Next.js
 nginx
 n8n
+Nango
 Node.js
 (?i)noindex
 nondeterministic
@@ -344,6 +356,7 @@ req
 res
 REST
 resubmit
+reupload(s|ed|ing)?
 revalidat(es?|ion)
 ROI
 Ronan
@@ -356,6 +369,7 @@ rulesets?
 runtime
 Rust
 SaaS
+Salesforce
 SAML
 sanitization
 Scala
@@ -366,11 +380,13 @@ scrollbar
 scss
 SDK
 SDKs
+searchable
 SendSafely
 SEO
 serverless
 sessionRecording
 setup
+shard(s|ing)?
 Shiki
 shortcodes?
 sidebars?
@@ -446,6 +462,7 @@ UIs
 (?i)unauthenticated
 uncached
 uncategorized
+(?i)uncheck(s|ed|ing)?
 unclickable
 undefined
 ungroup(s|ed|ing)?

diff --git a/admin-openapi.json b/admin-openapi.json
@@ -29,7 +29,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Your project ID. Can be copied from the [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) page in your dashboard."
+            "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
           }
         ],
         "requestBody": {
@@ -126,7 +126,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Your project ID. Can be copied from the [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) page in your dashboard."
+            "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
           },
           {
             "name": "id",
@@ -237,7 +237,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Your project ID. Can be copied from the [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) page in your dashboard."
+            "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
           },
           {
             "name": "skip",
@@ -370,7 +370,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Your project ID. Can be copied from the [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) page in your dashboard."
+            "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
           }
         ],
         "requestBody": {
@@ -437,7 +437,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Your project ID. Can be copied from the [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) page in your dashboard."
+            "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
           },
           {
             "name": "id",
@@ -485,7 +485,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Your project ID. Can be copied from the [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) page in your dashboard."
+            "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
           },
           {
             "name": "id",
@@ -627,7 +627,7 @@
       "bearerAuth": {
         "type": "http",
         "scheme": "bearer",
-        "description": "The Authorization header expects a Bearer token. Use an admin API key (prefixed with `mint_`). This is a server-side secret key. Generate one on the [API keys page](https://dashboard.mintlify.com/settings/organization/api-keys) in your dashboard."
+        "description": "The Authorization header expects a Bearer token. Use an admin API key (prefixed with `mint_`). This is a server-side secret key. Generate one on the [API keys page](https://app.mintlify.com/settings/organization/api-keys) in your dashboard."
       }
     }
   }

diff --git a/agent/effective-prompts.mdx b/agent/effective-prompts.mdx
@@ -26,7 +26,7 @@ Use broad prompts for general content maintenance like fixing typos, updating re
 
 If you have multiple documentation sites, include the `subdomain` parameter in your message to specify which documentation set the agent should work on.
 
-To find your domain name, look at your dashboard URL for the documentation set you want to update. The domain name is the last part after your organization name. For example, if your dashboard URL is `https://dashboard.mintlify.com/org-name/domain-name`, your domain name is `domain-name`.
+To find your domain name, look at your dashboard URL for the documentation set you want to update. The domain name is the last part after your organization name. For example, if your dashboard URL is `https://app.mintlify.com/org-name/domain-name`, your domain name is `domain-name`.
 
 Use the format `@mintlify subdomain=<your-domain-name> <your-prompt>` to prompt the agent to work on a specific documentation set.
 

diff --git a/agent/index.mdx b/agent/index.mdx
@@ -6,10 +6,6 @@ keywords: ["automation", "automate", "AI", "autoupdate", "maintenance"]
 
 import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx";
 
-<Info>
-  The agent is available on [Pro and Enterprise plans](https://mintlify.com/pricing?ref=agent).
-</Info>
-
 The agent is an AI tool that creates pull requests with proposed changes to your documentation based on your prompts. When you send a request, the agent:
 
 - **Researches**: Searches and reads your existing documentation, any connected repositories, relevant context, and the web.
@@ -29,6 +25,7 @@ Use the agent to:
 - Process and include images, diagrams, and other files from Slack attachments.
 - Search and revise code examples and API references across your docs.
 - Reference source code from any repository that has the Mintlify GitHub App installed.
+- Pull live context from connected apps like Slack, Notion, Linear, and Jira.
 - Automate documentation maintenance with workflows.
 - Answer questions about your docs and technical writing topics.
 - Address code review feedback to maintain documentation quality.
@@ -37,7 +34,7 @@ Use the agent to:
 
 ## Connect your GitHub account
 
-By default, the agent opens pull requests attributed to the Mintlify bot. To attribute pull requests to you, connect your GitHub account on the [My profile](https://dashboard.mintlify.com/settings/account) page of the dashboard.
+By default, the agent opens pull requests attributed to the Mintlify bot. To attribute pull requests to you, connect your GitHub account on the [My profile](https://app.mintlify.com/settings/account) page of the dashboard.
 
 ## Connect repositories as context
 
@@ -56,8 +53,8 @@ To let an external agent edit your content directly through MCP tool calls, conn
 <Card title="Connect Slack" horizontal icon="slack" href="/agent/slack">
 Add the agent to your Slack workspace.
 </Card>
-<Card title="Connect Notion" horizontal icon="notion" href="/agent/notion">
-Give the agent access to your Notion workspace.
+<Card title="Connect integrations" horizontal icon="plug" href="/agent/integrations">
+Give the agent access to Slack, Notion, Linear, and other tools.
 </Card>
 <Card title="Customize behavior" horizontal icon="wrench" href="/agent/customize">
 Configure the agent with an `AGENTS.md` file.

diff --git a/agent/integrations.mdx b/agent/integrations.mdx
@@ -0,0 +1,50 @@
+---
+title: "Agent integrations"
+description: "Connect third-party apps so the agent can pull live context from Slack, Notion, Linear, Jira, and other tools when answering questions and updating content."
+keywords: ["integrations", "Slack", "Notion", "Linear", "Jira", "Salesforce", "Intercom", "Google Calendar", "context", "Nango"]
+---
+
+Agent integrations give the agent access to context from other tools that your team uses. Once connected, the agent can search Slack threads, read Notion pages, look up Linear issues, and pull context from other apps to inform its responses and content updates.
+
+## Connect an integration
+
+Admins and editors can connect an integration for their organization from the dashboard.
+
+1. Go to the [Agent integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard.
+2. Find the integration you want to connect.
+3. Click **Connect**.
+4. Follow the OAuth prompts to authorize Mintlify to access your account.
+
+Some integrations, like Jira and Salesforce, open an additional configuration step to enter your workspace URL or subdomain before the OAuth flow begins.
+
+Once connected, everyone in your organization can prompt the agent to use the integration in Slack or for workflows that support integrations.
+
+## Supported integrations
+
+- Google Calendar
+- Intercom
+- Jira
+- Linear
+- Notion
+- Salesforce
+- Slack
+
+## How the agent uses integrations
+
+The agent uses connected integrations as tools. When you ask the agent a question or give it a task, it can search and retrieve content from your connected apps to build context.
+
+For example:
+- "Summarize the Slack thread about the v2 API migration and write it up for the knowledge base."
+- "Check the Linear ticket for this feature and document the behavior."
+- "What did the team decide about rate limiting? Check Slack."
+
+The agent only accesses integration data when it's relevant to the request. It does not proactively read from connected apps.
+
+## Disconnect an integration
+
+1. Go to the [Agent integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard.
+2. Find the connected integration you want to disconnect.
+3. Click **Configure**.
+4. Click **Disconnect**.
+
+Disconnecting removes the integration for your organization. The agent immediately loses access to that tool.
diff --git a/agent/notion.mdx b/agent/notion.mdx