mintlify · kyan-yang · Aug 6, 2026 · Aug 5, 2026 · Aug 5, 2026 · Aug 5, 2026
diff --git a/ai-native.mdx b/ai-native.mdx
@@ -39,6 +39,8 @@ Mintlify hosts `llms.txt` and `skill.md` files for your documentation. These ind
 
 Your documentation site also hosts an MCP server that lets users connect your documentation directly to their AI tools for up-to-date information about your product directly where they want it.
 
+For implementation questions that span multiple products or require web search, [Mintlify Index](/search-index) gives coding agents one MCP server and REST API for retrieving context from publisher-maintained documentation and the web.
+
 Full-text search and semantic understanding help users and AI tools find relevant information quickly. Search understands user intent rather than just matching keywords. And if a user encounters a 404 error, your site suggests related pages to help them find what they're looking for. No configuration required.
 
 ## Enable AI features

diff --git a/ai/mintlify-mcp.mdx b/ai/mintlify-mcp.mdx
@@ -17,14 +17,16 @@ Connect any MCP client like Claude, Claude Code, ChatGPT, or Cursor to the admin
 
 The admin MCP is a hosted Mintlify service at `https://mcp.mintlify.com`. Every client connects to the same endpoint and authenticates with your Mintlify account.
 
-### How the admin MCP differs from the search MCP
-
-|  | Admin MCP | Search MCP |
-| :-- | :-- | :-- |
-| **Audience** | Your team | Your end users |
-| **Access** | Read, edit, restructure, save, create workflows, manage settings | Read and search published pages |
-| **Endpoints** | Hosted by Mintlify, scoped to your project | `/mcp` on your site domain |
-| **Output** | Content edits, navigation changes, pull requests, workflow runs | Search results and page content |
+### How the admin MCP differs from other Mintlify MCP servers
+
+|  | Admin MCP | Search MCP | Index MCP |
+| :-- | :-- | :-- | :-- |
+| **Audience** | Your team | Your end users | All developers and agents |
+| **Access** | Read, edit, restructure, save, create workflows, manage settings | Read and search one site's published pages | Read and search all Mintlify sites |
+| **Endpoint** | `https://mcp.mintlify.com` | `/mcp` on your site domain | `https://index.mintlify.com` |
+| **Output** | Content edits, navigation changes, pull requests, workflow runs | Search results and page content from your site | Search results and page content from all Mintlify sites |
+
+See the [Mintlify Index MCP reference](/search-index/mcp) for its tool inputs and rate limits.
 
 ## Prerequisites
 

diff --git a/ai/model-context-protocol.mdx b/ai/model-context-protocol.mdx
@@ -14,7 +14,7 @@
 Your search MCP server exposes tools for AI applications to search and retrieve your content. Your users must connect your search MCP server to their tools.
 
 <Tip>
-  Looking to let agents edit your content instead of read it? Use the [admin MCP server](/ai/mintlify-mcp) for an authenticated MCP server that exposes branching, page editing, navigation, and `docs.json` tools to trusted agents.
+  To let trusted agents edit your content, use the [admin MCP server](/ai/mintlify-mcp). To give coding agents one retrieval source across all Mintlify sites, use [Mintlify Index](/search-index).
 </Tip>
 
 ### How MCP servers work
@@ -583,7 +583,7 @@

 <PreviewButton href="https://vscode.dev/redirect/mcp/install?name=mintlify&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmintlify.com%2Fdocs%2Fmcp%22%7D">Install in VS Code</PreviewButton>

 To connect the Mintlify MCP server to VS Code, click the **Install in VS Code** button. Or to manually connect the MCP server, create a `.vscode/mcp.json` file and add:

 ```json
 {

diff --git a/api/introduction.mdx b/api/introduction.mdx
@@ -6,7 +6,9 @@
 ---
 
 <Info>
-  The REST API requires a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=api).
+  The platform REST API requires a [Pro or Enterprise plan](https://mintlify.com/pricing?ref=api).
+
+  The [Mintlify Index REST API](/api/search-index/introduction) uses a separate API key and base URL.
 </Info>
 
 The Mintlify REST (Representational State Transfer) API enables you to programmatically interact with your documentation, trigger updates, embed AI-powered chat experiences, and export analytics data.
@@ -45,18 +47,19 @@
 
 ## Authentication
 
-Generate API keys on the [API keys page](https://app.mintlify.com/settings/organization/api-keys) in your dashboard. Each API key belongs to an organization—you can use keys across multiple deployments within the same organization.
+Generate API keys on the [API keys page](https://app.mintlify.com/settings/organization/api-keys) in your dashboard. Admin and Index API keys belong to an organization-you can use the same keys across multiple deployments withing the same organization. Assistant API keys belong to the deployment where you create them.
 
 You can create up to 10 API keys per hour per organization.
 
 When you create a key, you can set it to expire in 7, 30, 60, or 90 days, or select **No expiration**. New keys default to 90 days. The API keys page shows an **Expires in …** badge for keys that expire within 7 days and an **Expired** badge for keys that have already expired. Expired keys stop working, so rotate or replace them before the expiration date.
 
-Mintlify uses two types of API keys, each scoped to a different set of endpoints:
+Mintlify uses three types of API keys, each scoped to a different set of endpoints:
 
-| Key type          | Prefix      | Use for                                                                                 |
-| ----------------- | ----------- | --------------------------------------------------------------------------------------- |
-| Admin API key     | `mint_`     | Updates, agent jobs, and analytics exports. Server-side only.                           |
-| Assistant API key | `mint_dsc_` | Assistant messages, documentation search, and page content. Proxy in production.        |
+| Key type          | Prefix      | Use for                                                                          |
+| ----------------- | ----------- | -------------------------------------------------------------------------------- |
+| Admin API key     | `mint_`     | Updates, agent jobs, and analytics exports. Server-side only.                    |
+| Assistant API key | `mint_dsc_` | Assistant messages, documentation search, and page content. Proxy in production. |
+| Index API key     | `mint_us_`  | Index search, context assembly, and content retrieval. Server-side only.         |
 
 ### Admin API key
 
@@ -102,20 +105,26 @@
   Search documentation and page content requests do not consume credits. Assistant message requests use credits and can incur overages.
 </Note>
 
+### Index API key
+
+Use an Index API key to authenticate requests to the [Mintlify Index](/search-index) REST API. Index API keys begin with the `mint_us_` prefix.
+
+The Index API key is a server-side secret. Do not expose it in client-side code.
+
 ### Restrict keys by IP address
 
-Optionally restrict an API key to a list of allowed IP addresses or CIDR ranges. When a key has an allowlist, requests from any other IP address return a `403` response. Both admin and assistant API keys support allowlists.
+Optionally restrict an API key to a list of allowed IP addresses or CIDR ranges. When a key has an allowlist, requests from any other IP address return a `403` response. Admin, assistant, and Index API keys support allowlists.
 
 Set the allowlist when you create a key on the [API keys page](https://app.mintlify.com/settings/organization/api-keys) in your dashboard. You set the allowlist for the lifetime of the key when you create it. To change the allowlist, you must create a new key. If you don't set an allowlist, the key accepts requests from any IP address.
 
 Allowlist entries support:

 - IPv4 and IPv6 addresses, for example `203.0.113.5` or `2001:db8::1`.
 - CIDR ranges, for example `198.51.100.0/24` or `2001:db8::/48`.

 You cannot use catch-all entries like `0.0.0.0/0` and `::/0`.

 Use IP allowlists when a stable set of egress IPs call your API key. For example, a CI/CD runner, a static NAT gateway, or your backend server. Avoid allowlists for keys used from developer laptops or other environments with changing IPs.

 ### Restrict admin keys by scope

@@ -136,10 +145,10 @@
 
 ### Set an expiration date
 
-Optionally set an expiration date on any API key at creation. After the expiration timestamp passes, requests using the key return a `403` response. Both admin and assistant API keys support expiration.
+Optionally set an expiration date on any API key at creation. After the expiration timestamp passes, requests using the key return a `401` response. All API keys support expiration.
 
 Set the expiration on the [API keys page](https://app.mintlify.com/settings/organization/api-keys) in your dashboard. You set the expiration for the lifetime of the key. To change it, you must create a new key. If you don't set an expiration, the key never expires.
 
 The expiration must be a future ISO 8601 timestamp. Past or invalid timestamps return a `400` response at key creation. The expiration returns as `expiresAt` when you list keys, or `null` for keys with no expiration.

 Use expirations for short-lived credentials, such as CI/CD tokens, external contractors, or one-off scripts. Rotate long-lived keys by creating a replacement, updating your integrations, and deleting the old key.
diff --git a/api/search-index/contents.mdx b/api/search-index/contents.mdx
@@ -0,0 +1,7 @@
+---
+title: "Get result contents"
+sidebarTitle: "Contents"
+description: "Retrieve content from Mintlify Index by result ID or result URL after searching."
+keywords: ["Mintlify Index", "contents API", "result IDs", "URLs"]
+openapi: "/index-openapi.json POST /v1/contents"
+---
diff --git a/api/search-index/context.mdx b/api/search-index/context.mdx
@@ -0,0 +1,7 @@
+---
+title: "Build implementation context"
+sidebarTitle: "Context"
+description: "Assemble source-cited technical context within a token budget for an application or agent."
+keywords: ["Mintlify Index", "context", "citations", "token budget"]
+openapi: "/index-openapi.json POST /v1/context"
+---
diff --git a/api/search-index/introduction.mdx b/api/search-index/introduction.mdx
@@ -0,0 +1,93 @@
+---
+title: "Mintlify Index REST API"
+sidebarTitle: "Overview"
+description: "Use the Mintlify Index REST API to search documentation and the web, assemble source-cited context, and retrieve page contents for applications and agents."
+keywords: ["Mintlify Index API", "REST API", "authentication", "API key"]
+---
+
+Use the Mintlify Index REST API to retrieve technical knowledge for applications and agents. The API supports three retrieval patterns:
+
+- [`context`](/api/search-index/context) assembles source-cited content within a token budget.
+- [`search`](/api/search-index/search) returns ranked documentation and web results.
+- [`contents`](/api/search-index/contents) retrieves content for selected Mintlify result IDs or result URLs.
+
+<Info>
+  The REST API requires an API key for your organization. The public [Index MCP server](/search-index/mcp) does not require an API key.
+</Info>
+
+## Base URL
+
+Send REST API requests to:
+
+```text
+https://leaves.mintlify.com/api/universal-search/v1
+```
+
+Append an endpoint path to this base URL, for example `/context`, `/search`, or `/contents`.
+
+## Authentication
+
+Authenticate each request with an Index API key in the `Authorization` header:
+
+```http
+Authorization: Bearer mint_us_...
+```
+
+Index API keys begin with `mint_us_`.
+
+<Steps>
+  <Step title="Create an Index API key">
+    Open the [API keys page](https://app.mintlify.com/settings/organization/api-keys) in your dashboard and create an Index API key.
+
+    If this key type is unavailable, your organization does not have access to the Index REST API.
+  </Step>
+  <Step title="Store the key securely">
+    Save the key in a server-side environment variable. Mintlify only displays the complete key when you first create it. Store it securely.
+
+    ```bash
+    export MINTLIFY_INDEX_API_KEY="mint_us_..."
+    ```
+
+    <Warning>
+      Do not expose an Index API key in client-side code or commit it to version control.
+    </Warning>
+  </Step>
+  <Step title="Build context">
+    Send your first request to the `context` endpoint:
+
+    ```bash
+    curl -X POST "https://leaves.mintlify.com/api/universal-search/v1/context" \
+      -H "Authorization: Bearer $MINTLIFY_INDEX_API_KEY" \
+      -H "Content-Type: application/json" \
+      -d '{
+        "query": "How should I configure caching in Next.js 16?",
+        "product": "Next.js",
+        "format": "txt",
+        "tokenBudget": 3000
+      }'
+    ```
+
+    A successful response includes assembled context with source URLs, the number of results used, and the output token count.
+  </Step>
+</Steps>
+
+## Rate limits
+
+REST API limits apply per Mintlify organization. All API keys in an organization share the same limit:
+
+| Window | Limit |
+| --- | ---: |
+| Per second | 10 requests |
+| Per day | 1,000 requests |
+
+Requests exceeding either limit return `429 Too Many Requests`. Use exponential backoff before retrying.
+
+## Errors
+
+| Status | Meaning |
+| --- | --- |
+| `400` | The request body is invalid. |
+| `401` | The API key is missing or invalid, or the organization does not have Index REST API access. |
+| `403` | The request IP is not allowed by the API key. |
+| `429` | The organization exceeded a rate limit. |
+| `500` | Index could not complete the request. |
diff --git a/api/search-index/search.mdx b/api/search-index/search.mdx
@@ -0,0 +1,7 @@
+---
+title: "Search technical knowledge"
+sidebarTitle: "Search"
+description: "Search Mintlify Index for ranked technical documentation and web results."
+keywords: ["Mintlify Index", "search API", "technical documentation", "ranked results"]
+openapi: "/index-openapi.json POST /v1/search"
+---
diff --git a/changelog.mdx b/changelog.mdx
@@ -5,6 +5,17 @@
 noindex: true
 ---
 
+<Update label="August 5, 2026" tags={["New releases"]} rss={{ title:"Introducing Mintlify Index" }}>
+
+  ## Mintlify Index
+
+  [Mintlify Index](/search-index) gives coding agents one retrieval layer for publisher-maintained technical documentation and the web.
+
+  - **Public MCP server:** [Connect](/search-index/connect) coding agents without an API key. The `context` tool returns source-cited material for implementation tasks.
+  - **Access-controlled REST API:** Search ranked sources, assemble context within a token budget, and retrieve selected contents through separate API endpoints. Requires an Index API key.
+
+</Update>
+
 <Update label="July 31, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Introducing the widget, updated analytics, and more" }}>
 
   ## Mintlify widget
@@ -25,7 +36,7 @@
  - **Editor-first dashboard:** The editor is now the homepage of the Mintlify dashboard. Other pages, like activity, analytics, products, and settings, now open in a modal on top of it, and every page keeps its own URL.
  - **Redesigned editor:** New navigation tree, top bar, and page design. Create files in **Home** and structure your navigation in **Publishing**.
  - **Organization-level credits:** Credits are now shared at the organization level instead of per deployment, so every deployment on a plan draws from one shared balance. See [Credit pricing](/credits) for more information.
  - **Editor performance:** Navigation validation, page lookups, and tab switches in the editor are now linear instead of quadratic, so large sites open and edit faster.
  - **Personalization moved to add-ons:** [Personalization](/create/personalization) settings are now available under add-ons in the dashboard and no longer require a custom base path.
  - **Truncated pagination titles:** Long titles in next/previous footer links truncate so they no longer overflow.
  - **Long filename handling:** Uploaded files with names over 255 characters now truncate.
@@ -50,13 +61,13 @@

  ## GraphQL and SDK references

  - **GraphQL API reference pages:** Generate reference pages from a GraphQL SDL schema, with linked types and example queries, mutations, and responses. See [GraphQL setup](/api-playground/graphql-setup).
  - **SDK reference generation:** Build SDK reference pages directly from the output of TypeDoc, DocFX, Javadoc, Sphinx, or phpDocumentor. See [SDK reference setup](/api-playground/sdk-reference-setup).

  ## Editor and collaboration

  - **Review flow:** Request review on a draft, leave feedback, and approve or request changes before publishing. Reviews now support non-deploy branches.
  - **More ways to collaborate:** Start [comment threads](/editor/comments) on an entire page, mention yourself to leave a reminder, and use keybaord shortcuts <kbd>Option</kbd> + <kbd>C</kbd> or <kbd>Option</kbd> + <kbd>S</kbd> to comment on or suggest changes to selected text.
  - **Faster, more available editing:** The editor renders without waiting for the Git file tree and people without GitHub write access can use the editor.

  ## Automations, integrations, and Slack
@@ -112,8 +123,8 @@

  - **Faster deployment queues:** Preview deployments can now run more builds concurrently to reduce queue times.
  - **Resend member invitations:** Resend outstanding invitations to new organization members from the dashboard.
  - **Better signup feedback:** Signup now reports subdomain availability and suggests an available subdomain when your first choice is taken.
  - **Skipped deployment statuses:** The dashboard now shows when a deployment update was skipped instead of leaving its status unclear.
  - **Trailing-slash SEO config:** New `seo.trailingSlash` option in [`docs.json`](/organize/settings-seo) enforces consistent trailing-slash URLs across your site.

  ## Automations and Slack agent
@@ -138,9 +149,9 @@
  - Reduced assistant errors while a response is streaming.
  - Assistant chat history now preserves response text when a response ends with a tool call.
  - Mermaid diagram actions now show on hover as expected.
  - Version switcher is scoped to the versions available in the current dropdown.
  - Navigation-level `public: false` settings are now respected in authentication metadata.
  - Long chat-history messages are truncated instead of horizontally scrolling.
  - Static assets and favicons now send `X-Robots-Tag: noindex` to keep them out of search results.
  - `BreadcrumbList` JSON-LD no longer emits empty list items.

@@ -210,14 +221,14 @@
  ## Assistant skills and support handoff

  - **Assistant skills:** Add [skills](/assistant/skills) that the assistant loads on demand via a `loadSkill` tool call, so it can answer with your team's hand-written, opinionated guidance instead of relying on search results alone.
  - **Assistant contact form:** The [assistant](/assistant) can now present an in-chat contact form to hand off to support or sales when a question can't be answered from your content.
  - **Themed query categories in assistant analytics:** [Assistant analytics](/optimize/analytics) groups related questions into categories and shows thumbs-up/thumbs-down sentiment per category, so you can review frequent topics your users are asking about.
  - **Hosted MCP submit feedback tool:** Agents connected to your [hosted search MCP server](/ai/model-context-protocol#mcp-tools) can now report issues back to your team, recorded as unhelpful feedback in your analytics dashboard.

  ## Enterprise security

  - **Session IP allowlist:** Restrict dashboard sessions to allowed IP ranges as part of your [SSO and session security policy](/dashboard/sso).
  - **SCIM user provisioning and deprovisioning:** Provision and deprovision users through SCIM, with automatic session revocation, machine-credential revocation, and audit-log events when a user is deactivated.

  ## Improvements

@@ -225,10 +236,10 @@
  - **Hosted MCP admin connect page:** New admin connect page and hosted MCP auth settings in the dashboard under Settings.
  - **`searchable` frontmatter field:** Set `searchable: false` on a [page](/organize/pages) to omit it from site search results.
  - **`.md` routes for section pages:** Section landing and collection index pages now resolve at their `.md` route for AI/LLM tooling.
  - **`@mintlify` PR bot on fork branches:** The `@mintlify` GitHub bot now pushes comment edits directly to fork branches when the Mintlify app is installed on the fork, and supports PRs opened against docs repos.
  - **Publish concurrency safety in the editor:** The [editor](/editor) broadcasts when a publish starts so other clients block immediately, and the publish dropdown can be dismissed during loading. Publish failures now include a summary.
  - **Resumable editor agent streams:** The [editor agent](/editor) reconnects to in-flight streams after a disconnect instead of restarting from scratch.
  - **Slack agent resilience:** The [Slack agent](/agent/slack) recovers cleanly when a message is interrupted and no longer leaves loaders spinning; switch-deployment flows are hardened.
  - **SSO copy refresh:** The [SSO](/dashboard/sso) settings page has clearer sections and updated GitLab configuration instructions.
  - **Usage activity CSV export:** [Export your usage activity log](/credits#export-usage-activity) to CSV from the Usage page for deeper analysis, reporting, or record-keeping.

@@ -241,45 +252,45 @@
  - Editing a doc file's title in the editor no longer resets it to the default.
  - Assistant category occurrence counts now respect the selected date range.
  - Removed invalid `charset`, `canonical`, and `og:*` meta tags from rendered pages.
  - Automation run rows on the [automations page](/automations) are clickable to their details page, and the weekly run comparison indicator was removed.
  - Editor `docs.json` over 1 MB now falls back to the blob API so large configs load reliably.
  - Force-pushes to a connected Git branch are now handled gracefully during editor sync.
  - Self-hosted deployments correctly use the client URL as the preview base, and the self-host Lambda starts the self-hosted client.

 </Update>

 <Update label="June 26, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Google Drive agent integration, multi-source git settings, new onboarding, and more" }}>

  ## New releases

  - **Google Drive agent integration:** The agent can now pull context from Google Drive alongside Slack, Notion, Linear, Jira, and other [agent integrations](/agent/integrations).
  - **Multi-repository deployments:** Configure and reorder multiple Git sources for a deployment from the dashboard. See [multi-repo setup](/deploy/multi-repo).
  - **Assistant page navigation:** The [AI assistant](/assistant) can navigate users directly to a relevant page as part of its answer.
  - **Custom agent instructions in `llms.txt` and markdown:** Custom agent instructions are now included in [`llms.txt`, `llms-full.txt`](/ai/llmstxt), and per-page generated markdown.
  - **Mintlify Slack app in the Slack Marketplace:** The [Mintlify Slack app](/agent/slack) is now publicly listed and installable from the Slack Marketplace.

  ## Improvements

  - **Automation PR grouping:** When an [automation](/automations) run proposes new changes, it now checks whether they should be appended to an existing open docs PR rather than creating a new one, reducing duplicate PRs and review burden. Applies to Maintenance and Update from Code Changes automations.
  - **Automation GitHub PR review experience:** Docs PRs created by [automations](/automations) now post a comment each time they're updated, explaining what changed and which code PRs were used as context. PR titles identify which automation created them, reviewers are auto-assigned based on who changed the relevant code, and follow-up runs update the PR summary in place.
  - **HTML alternate link for markdown pages:** Every page now exposes an HTML `<link rel="alternate">` pointing to its [markdown version](/ai/llmstxt), making it easier for AI tools and crawlers to discover the LLM-friendly content.
  - **Real-time publish status in the editor:** The [editor](/editor) now shows publish actions as they happen so you can see exactly when a change goes live.
  - **Switch organization moved:** The **Switch organization** menu option is now in the profile dropdown menu.
  - **Cookie-consent gating for analytics:** Third-party analytics scripts (GA4, GTM, and others) are now blocked until a visitor accepts cookies, helping you meet privacy requirements.
  - **SSO enforcement on the frontend:** The dashboard now honors backend 403s for [SSO-only orgs](/dashboard/sso) and routes verified-domain users through SSO during sign-in.
  - **Search indexes section landing pages:** Section landing pages are now included in docs search results, and search indexes continue to build for sites that opt out of public indexing.
  - **Assistant CSV export grouping:** The assistant analytics CSV now includes a `Conversation ID` column and groups rows by conversation.
  - **MCP server identity and instructions:** The [Mintlify MCP server](/ai/mintlify-mcp) now advertises instructions on initialize, helping clients use it more effectively.
  - **Changelog automation runs show integration tools:** Automation runs that produce changelog entries now display the integration tools that were used.
  - **PDF export reliability:** Large PDF exports are now batched and produce clearer error logs when something goes wrong.

  ## Bug fixes

  - Subpath deployments now resolve `.well-known` links correctly.
  - Publishing from the editor no longer duplicates near-identical blocks during three-way merges.
  - Icon serialization in published pages is fixed.
  - Editor image uploads now retry if the request is rate limited.
  - MCP responses now forward upstream status codes correctly, and nested JSX is reconstructed properly for MCP clients.
  - The editor sidebar no longer renders a top fade gradient, and draft rows no longer show stale orange status dots.
  - Bold text inside headings renders with the correct weight.
  - The products selector dropdown column is wider so long names fit.
@@ -290,19 +301,19 @@

  ## New releases

  - **Workflows are now automations:** Introducing [automations](/automations). They have the same functionality as workflows, just a new name to better describe what they're helping you do.
  - **SSO enforcement and breakglass:** Org owners can enforce [SSO-only sign-in](/dashboard/sso) for members, configure verified domains, and manage breakglass emails from the dashboard for emergency access.
  - **Full PDF export for authenticated sites:** [Authenticated sites](/deploy/authentication-setup) can now generate full PDF exports, with auth cookies parsed so images and assets are included.
  - **Self-hosted improvements:** Self-hosted deployments can now serve a public docs domain, write `sitemap.xml` to S3 during static export, and support static exports. Webhooks now work in self-host mode.
  - **`mint analytics` command removed:** The command `mint analytics` is deprecated.

  ## Improvements

  - **Editor view changes:** Open an automation run's changed pages directly in the [editor](/editor) from the run review UI or Slack. Changed pages are highlighted, and unlisted pages are openable from the branch diff.
  - **Typing performance:** Fixed typing lag on long pages in the editor.
  - **Mintlify bot reliability:** The `@mintlify` GitHub bot is now more reliable across multi-comment iterations and posts a direct "view changes" link.
  - **Preview deployments:** Preview deployments now rebuild on push and are created from new webhook events for faster previews.
  - **Search modal redesign:** The search and assistant modal is redesigned with full keyboard and accessibility support and no flicker on open.
  - **Mobile menu redesign:** The docs topbar mobile menu has a refreshed design.
  - **Product dropdown menus:** Product dropdowns now support nested menus and divisions.
  - **Luma wide mode:** `mode: "wide"` now affects content positioning in the Luma theme.
@@ -312,11 +323,11 @@

  - Bold text inside headings now renders with the correct font weight.
  - Search modal primary color now matches the configured theme.
  - Authenticated MCP requests propagate upstream responses to clients, and the authed MCP config rate limit was raised.
  - Failed React components in the dashboard now render an error boundary instead of crashing the page.
  - Removed the copy button from command-line code blocks where it wasn't useful.
  - Duplicate merged changes during Git sync are now de-duplicated.
  - MCP OAuth routes are hidden when auth is disabled.
  - Assistant captcha copy updated for clarity.
 </Update>

@@ -328,9 +339,9 @@

  ## Editor improvements

  - **Drafts and publishing flow:** Make changes in a draft, request review, and publish — all from the [web editor](/editor). Drafts autocommit as you work, and renaming or updating a draft updates the underlying pull request.
  - **Create non-`.mdx` files:** Add JSON, YAML, and other supported file types directly from the editor file tree.
  - **Topbar redesign:** A cleaner editor topbar with reorganized controls.
  - **Faster initial load:** The editor's first file and navigation load is significantly faster, with prefetching for visible nav tree pages.
  - **New link UX:** A redesigned inline link editor in the WYSIWYG view.
  - **Folding and sticky headings:** Long pages support collapsible headings, and sticky headings are clickable to jump back up the page.
@@ -339,10 +350,10 @@

  ## Search and AI

  - **Markdown in search results:** Search via MCP, the assistant, and the agent now returns markdown, giving AI clients better page context.
  - **Project-level noindex:** Site owners can hide an entire project from search engines.
  - **Unversioned search:** Pages without a version are included in search results when `searchSettings.unversioned` is set, with breadcrumbs that show their version context.
  - **Claude Code classification:** Analytics now recognize Claude Code user agents and count AI agent HTML pageviews alongside markdown views.

  ## Bug fixes

@@ -351,7 +362,7 @@
  - Click-to-reposition the cursor in the editor file tree rename input.
  - Adding files to `docs.json` in the editor no longer requires a reset.
  - Image renames in the editor now work.
  - The active page node is revealed in the editor navigation on load.
  - Search results anchor to the page top or title-matching section instead of arbitrary subsections.
  - Bad frontmatter no longer crashes page builds.
  - Automations home banner shows a toast when a custom automation delete fails, and prefers an error message over a summary for failed runs.
@@ -377,7 +388,7 @@

  ## Search

  - **Better ranking:** In-product search now supports prefix matching, title-match promotion, and unicode tokenization, so partial queries and identifier searches surface the right pages faster.
  - **Word-prefix highlighting:** Matching word prefixes highlight in search results.

  ## Improvements
@@ -392,7 +403,7 @@
  - Files in the editor file tree alphabetize after you create a new file.
  - Accordions open automatically when you navigate to their hash anchor on the same page.
  - The editor agent shows its overage and credit status before you send a message.
  - Slack agent installs are rejected when the workspace is already owned by another organization, preventing cross-org conflicts.
  - Future date selection in the dashboard uses the correct styles.
 </Update>

@@ -405,7 +416,7 @@
  - **Page settings panel:** The new page settings panel lets you view and edit frontmatter in the file explorer view.
  - **Hide branches toggle:** A new toggle hides branch indicators in the editor view for a cleaner workspace.
  - **Better link editing:** Editing inline links is faster with an improved link editor experience.
  - **Fullscreen table mode:** Edit large tables in a dedicated fullscreen view.
  - **Drag and drop Markdown:** You can now drag and drop Markdown files into the editor to upload them.
  - **Brand icons in icon picker:** Brand icons are now available alongside the rest of the icon library.

@@ -419,7 +430,7 @@
  ## Automations

  - **Draft improvements from user feedback:** This new automation reviews recent [page feedback](/optimize/feedback) and opens pull requests based on what users report.
  - The **update from code changes** automation (formerly sync content with code) defaults to run on a schedule rather than triggering on every code change. When it runs, the agent scans all code changes since the last run and opens one PR per related set of documentation updates. If a PR is still open from a previous automation run, new changes are appended to it rather than creating a new PR. This means a release worked on over several weeks produces a single docs PR to review instead of one per commit.
  - Automation titles and copy across the dashboard updated for clarity.

  ## API playground
@@ -451,11 +462,11 @@
  ## Bug fixes

  - Custom heading IDs now preserve casing (camelCase, snake_case, kebab-case).
  - Navigation breadcrumbs render above page-level hits in search results.
  - Enum defaults pre-populate when you add new array items in the API playground.
  - `.xml` files are now treated as valid link targets by the broken-links checker.
  - Changelog pages now include an RSS feed discovery meta tag so readers can subscribe directly from the page.
  - Bullet point behavior in the editor is fixed, including continuing and exiting lists.
  - Pasting copied web images no longer creates duplicate broken image nodes.
  - Large editor media uploads now use direct-to-S3 presigned URLs, bypassing the previous 4.5 MB function payload limit.
  - GitHub edit links now work correctly for `.md` pages.
@@ -463,12 +474,12 @@
 </Update>

 <Update label="May 22, 2026" tags={["New releases","Improvements"]} rss={{ title:"Web editor enhancements, new automation, search improvements, and more" }}>
  ## Web Editor

  We've continued to enhance our web editor with a number of functionality and UI improvements.

  - **More editable file types:** A broader set of file extensions can now be opened and edited directly in the web editor, while executable uploads are blocked for safety.
  - **Agent chat panel relocated:** The agent chat panel has been repolished and now sits to the left of the file explorer, making it easier to chat and navigate at the same time.
  - **Editor settings:** A new settings panel and redesigned settings modal give you a single place to manage per-editor preferences. See [Web editor](https://www.mintlify.com/docs/editor).
  - **File-tree navigation by default:** Newly onboarded users start in the file-tree view instead of the legacy list view.
  - **Browser tab titling:** The browser tab name now dynamically updates to match the active file, so you always know which file you're editing.
@@ -476,7 +487,7 @@
  ## Automations

  - New **Draft improvements from assistant conversations** automation reviews trends from user questions and suggests documentation updates to address gaps. See [Automations](/automations/reference#draft-improvements-from-assistant-conversations).
  - **Context repositories** can now be configured directly for some automations so you can add the repos an automation should reference while running.
  - Automation settings now open in a **side panel** instead of a modal, making it easier to tweak settings while reviewing Automation Runs.

  ## Search Improvements
@@ -493,19 +504,19 @@
  - **API playground**: `any` and `undefined` types are now handled like `oneOf` schemas, letting users pick a concrete shape when sending a request.
 </Update>

 <Update label="May 15, 2026" tags={["New releases","Improvements"]} rss={{ title:"Web editor redesign, expanded agent support, billing improvements, and more" }}>
  ## Web Editor

  The [editor](https://www.mintlify.com/docs/editor) has been redesigned for live collaboration, parsing, and stability. Additional improvements include:

  - **Agent panel**: Chat with the editor agent inline — attach files, view per-session diffs, leave feedback, and jump to the page the agent edited.
  - **Add to Assistant**: Send highlighted content straight to the [Assistant](https://www.mintlify.com/docs/assistant) from the editor toolbar.
  - **File tree**: Create folders, create unlisted pages, and rename items in the file tree. Add unlisted Markdown into the navigation tree, and open unlisted Markdown and media files directly from the tree.

  ## Improvements

  - **Automations**: New **Add GitHub repositories** link in the Automations repository dropdown makes it easier to connect additional repositories without leaving the page. The Automation Runs tab now defaults to **All runs** when nothing currently needs review, and a **View all runs** button on the empty state clears active filters in one click.
  - **Mintlify Agent**: The [Mintlify agent](https://www.mintlify.com/docs/agent/slack) can now be installed in your Slack workspace even without having a Mintlify-hosted deployment. Additionally, viewer-role users can now ask questions and get answers using read-only tools, and the agent now uses prior thread images and message reactions as additional context.
  - **Schema graph callbacks**: API reference pages now render OpenAPI `callbacks` in the schema graph.
  - **Danish language support** added.

@@ -524,13 +535,13 @@
 <Update label="May 8, 2026" tags={["New releases","Improvements"]} rss={{ title:"Expanded MCP access, assistant credit packages, AsyncAPI nested groups, and more" }}>
  ## Expanded MCP content access

  Authenticated [MCP servers](/ai/model-context-protocol) now return more of your content to authorized users. Authenticated users can search public pages plus any pages they have permission to access based on their user groups, instead of being limited to public pages only. [Client credentials](/ai/model-context-protocol#client-credentials) return all public pages and authenticated pages that aren't restricted to specific groups.

  The Mintlify MCP `list_nodes` tool now supports filtering by `parentId` (with optional `recursive` traversal), multiple node types, and additional division scopes including `dropdown`, `anchor`, `product`, and `item`. Results are paginated through an opaque cursor. See the [Mintlify MCP](/ai/mintlify-mcp) documentation for more details.

  ## Assistant credit packages

  The [assistant](/assistant) billing experience has been updated to use credit-based packages across all plans, with consistent terminology in the dashboard and usage controls. No changes to existing credit balances or usage.

  ## AsyncAPI nested groups

@@ -560,7 +571,7 @@

  ## Editor

  The [editor](https://app.mintlify.com/editor) is redesigned for better collaboration and improved stability. The editor now supports real-time collaboration, automatic saving across devices, and improved syncing.

  See the [editor](/editor) documentation for more details.

@@ -588,7 +599,7 @@

  ## Improvements

  - Control whether OpenAPI-generated reference pages are included in your [Markdown export](/ai/llmstxt) and `llms-full.txt`
  - Search improvements: matched query terms highlighted in search results, search indexes content inside alt text, tag-based search filters are case-insensitive, and snippets no longer duplicate page titles.
  - Banner components support more types and per-user dismissibility.
  - Authenticated navigation now stays sticky while scrolling.
@@ -599,7 +610,7 @@

  ## Bug fixes

  - Fixed copying of personalized code blocks so the rendered values are copied instead of the templated source.
  - Fixed prefetching incorrectly attempting to fetch external links.
  - Fixed prose styling for the [Tabs](/components/tabs) component.
  - Fixed offset alignment for blocks placed inside a [Column](/components/columns).
@@ -611,20 +622,20 @@
  - Fixed an automation card toggle that could blank the dashboard page.
 </Update>

 <Update label="April 24, 2026" tags={["New releases","Improvements"]} rss={{ title:"Preview Deployment API, Git onboarding redesign, web editor improvements, and more" }}>
  ## Preview Deployment API

  A public API for generating preview deployments is now available. Use it to trigger previews from your own tooling—useful when your Git workflow doesn't map cleanly to standard branch-based preview triggers. See [Trigger preview deployment](/api/preview/trigger) for more details.

  ## Git onboarding and settings redesign

  The Git settings page has been redesigned with a new layout. Mintlify-hosted customers migrating to their own GitHub or GitLab repository now get a step-by-step flow that walks through the full migration process.

  ## Web editor improvements

  The web editor now shows the full Git diff for the current branch, including changes already pushed. Review everything modified in one place before publishing or opening a pull request.

  Changes now persist locally, so edits made while offline are preserved and synced automatically when your connection returns.

  - **Emoji picker**: Type <kbd>:</kbd> to open an emoji picker and insert emojis inline.
  - **Accordion reordering**: Drag and drop to rearrange accordions inside an [accordion group](/components/accordions) without editing MDX.
@@ -638,7 +649,7 @@
  ## Improvements

  - Pages expose a `data-current-path` HTML attribute for easier custom scripting and analytics targeting.
  - Hidden pages now respect the `seo.indexing: all` setting so you can still index specific pages that are excluded from navigation.

  ## Bug fixes

@@ -679,17 +690,17 @@
  - Pasting valid MDX components into the editor now preserves component structure instead of converting to plain text.
  - Long sidebar navigation titles now hyphenate automatically to prevent overflow.
  - The editor now resolves [`$ref` references](/organize/settings#split-configuration-with-%24ref) in split configuration files.
  - The [Slack agent](/agent/slack) system prompt has been improved for more accurate and helpful responses.
  - `llms.txt` now includes blockquote summaries for better page descriptions.
  - Custom `skill.md` files in your repository are now detected correctly during deployment.

  ## Deprecations

  - File-based automations are deprecated. Create automations from the dashboard instead. Existing automations from files continue to work, but new automations must be created in the dashboard.

  ## Bug fixes

  - Fixed instances of relative links in `index.mdx` files not resolving correctly.
  - Fixed the copy button for code blocks in assistant responses.
  - Fixed the table of contents not updating after page content changes.
  - Fixed code block titles not displaying correctly.
@@ -719,11 +730,11 @@

  ## Multi-skill support

  Serve multiple [skill files](/ai/skillmd) from a `.mintlify/skills/` directory. Each subdirectory with a `SKILL.md` file is discovered and served automatically, so you can organize skills by feature or domain.

  ## Slack agent improvements

  - **Multiple deployments**: Organizations with multiple documentation sites can now use the [Slack agent](/agent/slack) across all of them. The agent prompts you to choose a deployment on first use, and your preference is saved per Slack account.
  - **Read-only mode**: The Slack agent now classifies messages and responds in read-only mode for questions that only need information retrieval, reserving write access for requests that require documentation changes.

  ## Client credentials for authenticated MCP
@@ -735,19 +746,19 @@
  - The [`mint new`](/cli/commands#mint-new) command now supports creating projects from pre-defined templates with the `--template` flag.
  - The CLI now auto-refreshes expired access tokens, so you no longer need to re-run `mint login` after a session expires.
  - The [assistant](/assistant/index) is now available in `mint dev` local previews.
  - CLI UX improvements: grayed-out login URLs for clarity, standardized log formatting, and `mint status` now shows the CLI version.
  - OpenAPI `x-group` extension support for organizing API endpoints into custom groups.
  - Horizontal rules (`<hr />`) are now supported in MDX content.
  - [Automations](/automations) now surface in the dashboard inbox for easier tracking. The automation list also displays PR names for quicker identification.
  - The `mint export` command now includes API reference pages generated from OpenAPI specifications.
  - The slash command menu in the editor has been redesigned with improved organization and discoverability.
  - Improved the UI of the editor publish flow and page creation interface.
  - Improved abuse prevention for the assistant.
  - Added Finnish as a supported localization language.

  ## Bug fixes

  - Fixed custom heading IDs not being processed before MDX parsing, which could cause anchors to break on certain pages.
  - Fixed the SEO and metadata audit automation template from incorrectly modifying API endpoint pages.
  - Fixed deprecated label text wrapping in the dashboard.
  - Fixed inline formatting (bold, italic, code) not applying correctly in the editor in certain contexts.
@@ -758,7 +769,7 @@
  - Fixed pages marked as hidden still appearing in the sitemap.
 </Update>

 <Update label="April 3, 2026" tags={["New releases","Improvements"]} rss={{ title:"get_page MCP tool, password-protected previews, SAML group role mappings, and more" }}>
  ## get\_page MCP tool

  [MCP servers](/ai/model-context-protocol) that Mintlify generates now include a `get_page` tool that lets AI agents fetch full page content by path. Agents can retrieve complete documentation pages for deeper context beyond search results.
@@ -775,8 +786,8 @@

  - Redesigned the editor configuration settings page with an improved layout and autosave support.
  - Pages auto-generated from OpenAPI specifications now appear in the web editor as read-only entries.
  - Video support in [live preview](/editor/live-preview). Embedded mp4, webm, and mov files now render correctly during local development.
  - [Automations](/automations) can now be disabled and re-enabled from the dashboard.
  - Assistant analytics now show usage broken down by source (web vs API) in the dashboard.
  - Authenticated MCP search now correctly filters results based on the user's authentication groups.
  - Slack agent responses now show tool call summaries instead of raw tool calls for clearer information of what the agent is doing.
@@ -826,7 +837,7 @@

  ## API playground credentials

  A new [`api.playground.credentials`](/api-playground/overview) option sends browser-managed credentials (like cookies and session tokens) with API playground requests when the proxy is disabled. Useful for APIs that use cookie-based authentication.

  ## Improvements

@@ -851,7 +862,7 @@
  - Fixed padding for tables inside tabs.
  - Fixed Frame component hint icon vertical alignment.
  - Fixed navigation item badge wrapping.
  - Fixed API key being erased during prefill examples.
  - Fixed linked code snippets in cards not being clickable.
 </Update>

@@ -957,9 +968,9 @@

  The assistant now also builds context from the page a user is on and indexes entire OpenAPI specifications.

  ## Default Vale configuration updates

  The default [Vale configuration](/deploy/ci#configuration) now parses MDX as MD to avoid fragility with JSX. Previously, Vale returned false positive errors on any JSX inside of MDX components. Now, Vale parses MDX as MD to avoid these errors with tokenIgnores and blockIgnores for MDX and JSX elements that Vale should skip.

  ## Improvements

@@ -1026,7 +1037,7 @@

  ## Improvements

  - New search functionality in the web editor makes it easier to find and navigate to files across your documentation.
  - Drag to add table rows and columns directly in the editor for faster table creation and modification.
  - The API playground now supports audio response examples, making it easier to document audio-related API endpoints.

@@ -1055,7 +1066,7 @@

  The [contextual menu](/ai/contextual-menu) now includes an option to add a copyable command to install your docs MCP server.

  ## `root` in groups

  Navigation groups now support a [`root`](/organize/navigation#root-page) property to set a landing page for the group. Clicking the group header navigates to the root page instead of expanding the group.

@@ -1147,7 +1158,7 @@
 </Update>

 <Update label="January 23, 2026" tags={["New releases","Improvements"]} rss={{ title:"skills.md, audit logs, and markdown export" }}>
  ## `skill.md` auto-generation

  Documentation sites now auto-generate a `skill.md` file based on your API references, guides, and features to give AI agents a comprehensive skills file with context on how to help people use your product. `skill.md` replaces the `install.md` approach with more structured capabilities and wider adoption. If you have a custom `skills.md` file at the root of your documentation repository, it replaces the auto-generated version. See [skill.md](/ai/skillmd) for more information.

@@ -1157,17 +1168,17 @@

  ## Markdown export for agents

  Documentation pages now serve raw markdown when the `Accept: text/markdown` header is sent, which enables better AI agent consumption of content.

  ## Improvements

  - Combined authentication, partial authentication, and personalization into a single authentication experience. See [Authentication setup](/deploy/authentication-setup) for more information.
  - Hidden pages now automatically receive `noindex` meta tags for better SEO control.
  - Added markdown support for image captions.
 </Update>

 <Update label="January 16, 2026" tags={["New releases","Improvements"]} rss={{ title:"install.md, live preview in the web editor, and more" }}>
  ## `install.md` auto-generation

  Documentation sites now auto-generate an `install.md` file that aggregates installation-related pages like quickstarts, getting started, installation, and setup guides for AI agents. If you have a custom `install.md` file in your documentation repository, it takes priority over the auto-generated version.

@@ -1178,7 +1189,7 @@

  ## Branch search for Git integrations

  Added branch search functionality for GitHub and GitLab integrations so that it is easier to find and switch between deployment branches in the Git settings of your dashboard.

  ## `mintlify validate` CLI command

@@ -1239,7 +1250,7 @@
  You can now [customize your Slack bot](/ai/slack-bot) directly from the dashboard.

  - **Choose a reply channel**: Select which channel the bot automatically replies to all messages in. The default is `#ask-ai`.
  - **Customize the bot's appearance**: Change the bot's avatar and name from your dashboard.

  ## Mobile navigation improvements

@@ -1273,7 +1284,7 @@
  - Updated [publishing workflow](/editor/branching-and-publishing) to support one-click publishing or creating pull requests.
  - Working in the web editor no longer requires you to sign in with GitHub.

  ## Onboarding improvements

  - Choose between a Mintlify-hosted documentation repository or using your own repository while signing up.
  - Create a documentation site without connecting a GitHub account.
@@ -1291,8 +1302,8 @@
 <Update label="December 12, 2025" tags={["New releases","Improvements"]} rss={{ title:"Agent suggestions and Q&A bots" }}>
  ## Agent suggestions

  The agent can now monitor Git repositories and suggest documentation updates. When user-facing code changes are detected, suggestions appear in the agent panel. Suggestions include the relevant pull request and a list of proposed documentation updates. Add suggestions as context for the agent to create pull requests or dismiss them.

  ## Q&A bot in Slack

  Add a bot powered by the assistant to your [Slack workspaces](/ai/slack-bot). The bot answers questions in real-time based on your documentation, so it provides accurate, up-to-date answers to your community.
@@ -1307,7 +1318,7 @@

  - **Insights** renamed to **Analytics** in the dashboard.
  - Added ability to delete a deployment from the dashboard.
  - The `Tooltip` component has been redesigned with improved styling and now supports an optional `headline` prop for adding a title to your tooltips.
  - The `mint a11y` command now supports `--skip-contrast` and `--skip-alt-text` flags, allowing you to run specific accessibility checks in your CI/CD pipeline. Use `--skip-contrast` to check only for missing alt text, or `--skip-alt-text` to check only color contrast ratios.

  ## Bug fixes
@@ -1316,11 +1327,11 @@
  - Fixed heading levels 5 and 6 rendering in the web editor.
  - Fixed schema page examples display in API reference pages.
  - Fixed image upload paths in monorepo setups.
  - Fixed an issue where the incorrect request payload value was being selected first in the API playground.
  - Removed file extensions from default image titles when uploading.
  - Fixed double underline styling on banner links.
  - Fixed loading states and date range values for analytics page.
  - Folders in the web editor now properly maintain their open/closed state when other folders are opened or closed.
  - Fixed long API page titles overflowing instead of wrapping.
 </Update>

@@ -1340,7 +1351,7 @@

  You can now display "last modified" timestamps on all pages in your documentation. Enable this feature by setting the [`timestamp`](/organize/settings-seo#metadata) flag in your `docs.json` settings.

  When enabled, each page will automatically show when it was last updated, helping readers understand how current the content is.
 </Update>

 <Update label="December 5, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"API playground enhancements, web editor improvements, and bug fixes" }}>
@@ -1354,8 +1365,8 @@

  ## Assistant improvements

  - Fixed assistant submission to prevent empty messages from being sent.
  - Fixed accidental message submission during IME composition (for languages like Japanese, Chinese, Korean).
  - Better behavior when adding code snippets to assistant.

  ## Bug fixes and reliability
@@ -1363,7 +1374,7 @@
  - Fixed handling of complex Mermaid diagrams.
  - Fixed hash handling for URLs and table of contents to properly highlight the active page when accessing the root path with an index page.
  - Added ability to disable 404 page recommendations via configuration.
  - Fixed a bug in the API playground where boolean `false` and numeric `0` values in query parameters would be filtered out and not appear in the generated API request.
 </Update>

 <Update label="December 3, 2025" tags={["New releases"]} rss={{ title:"Assistant query bucketing",description:"Automatically group similar assistant queries to identify common user questions" }}>
@@ -1377,7 +1388,7 @@
 <Update label="December 1, 2025" tags={["New releases"]} rss={{ title:".mintignore support",description:"Exclude files and directories from your published documentation" }}>
  ## .mintignore support

  - Added `.mintignore` file support to exclude specific files and directories from being processed and published to your documentation site.
  - Uses the same pattern syntax as `.gitignore` for familiar configuration.
  - Excluded files don't appear in published docs, aren't indexed for search, and aren't accessible to visitors.

@@ -1396,7 +1407,7 @@
  - Fixed issue where response section would disappear when switching between endpoints with different response codes. The playground now properly resets to the first available response code when navigating to a new endpoint.
  - Fixed double "Authorization" header display in HTTP Basic authentication schemes. The authentication section now shows a cleaner interface with proper field labels and descriptions.
  - Improved handling of `oneOf` schemas in nested objects and arrays. Complex API schemas with multiple type options now render correctly as dropdowns instead of tabs in appropriate contexts.
  - Fixed missing path parameters that were defined at the endpoint level in OpenAPI specs. Parameters specified above individual operations are now properly included in both the main page and playground.
  - Enhanced response example generation to include all required properties, even when examples only specify some fields. This ensures response examples are complete and accurate.
  - Fixed missing prefill examples in object arrays. Array items with example data now properly populate in the playground with correct indexing.
  - Improved description padding and spacing throughout the API playground for better readability and visual consistency.
@@ -1407,7 +1418,7 @@

  ## CLI improvements

  - Added error message for users running `mint dev` on Node.js versions below 20.17. Users are guided to upgrade to an LTS version.
 </Update>

 <Update label="November 15, 2025" tags={["New releases","Improvements"]} rss={{ title:"Weekly Updates",description:"Badge component, API playground improvements, custom language support, and performance enhancements" }}>
@@ -1425,14 +1436,14 @@
  - Security inputs defined at the operation level in OpenAPI specs now properly override top-level security definitions
  - Fixed issue where header inputs marked as security parameters were incorrectly included in generated code examples
  - Improved handling of `deepObject` style parameters in API field displays
  - Better error messages when invalid URLs are provided in API configurations
  - Improved UI for API playground with better spacing, layout, and loading

  ## Navigation and UI enhancements

  - Tab hover indicators now have improved styling for better visual feedback
  - Long words now wrap properly to prevent horizontal scrolling
  - Step component now handles cases where no step title is provided
  - Logo section spacing improved with better padding
  - Fixed heading IDs to properly handle question marks and special characters for anchor links
  - Icon component now accepts `className` prop for custom styling
@@ -1447,7 +1458,7 @@

  ## Component and styling enhancements

  - Images can now be zoomed with improved overlay styling for both light and dark modes
  - Fixed keyboard shortcut styles inside callouts for dark mode
  - Improved OG image generation with Google Fonts support and better truncation logic
  - Improved UI for tables with better alignment, spacing, and readability
@@ -1473,14 +1484,14 @@
 <Update label="October 31, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"API playground enhancements, table improvements, performance optimizations, and bug fixes" }}>
  ## Assistant improvements

  - **Starter questions for assistant are here! You can add your own within the dashboard at [Assistant --\> Settings](https://app.mintlify.com/mintlify/mintlify/products/assistant/settings)**
  - Assistant insights quality has been improved with default spam protection for abusive keywords and JSON queries.

  ## API playground improvements

  - The API playground now automatically fills in default values for parameters, which saves time when testing endpoints.
  - Issues with `allOf`, `oneOf`, and nested object schemas that previously caused rendering problems or incorrect field displays have been fixed, and complex API schemas now render correctly with all fields visible and properly structured.
  - Enum and nullable field types now display accurate labels in the playground, which makes it clearer what values are accepted and whether fields are optional.
  - When working with nested objects in API requests, the playground now shows proper descriptive labels for each field instead of generic placeholders, which makes it easier to understand what data to provide.
  - Enum const tables and API field displays now render with improved formatting and alignment, which makes it easier to scan available options and understand field requirements.
  - API playground modals now display rich MDX-formatted descriptions at the top, which gives better context for endpoints with formatted text, links, and code examples.
@@ -1488,7 +1499,7 @@
  ## Analytics changes

  - Deferred analytics loading: PostHog and LogRocket now load after documentation content, which improves initial page load times and Core Web Vitals scores without affecting analytics data.
  - Conditional session recording: PostHog session recording can now be enabled conditionally based on user properties or page context for more control over when recordings happen.

  ## Visual improvements

@@ -1511,7 +1522,7 @@
  ## Insights improvements

  - Improved insights page with fixed date selectors for "today" and "yesterday"
  - Enhanced feedback table with improved search functionality
  - Added loading state for categories table

  ## Assistant improvements
@@ -1626,13 +1637,13 @@
  ## Bug fixes and reliability

  - Fixed duplicate base paths and links in 404 recommended pages
  - Auto-populated og:url tag with appropriate canonical URL
  - Added canonical tag for better SEO
  - Fixed code block overscroll issues
  - Made search engines ignore preview deployments for SEO purposes
  - Fixed referrer tracking to use domain instead of full URL
  - Fixed images always becoming MDX block elements (kept inline images inline)
  - Removed comments in raw markdown pages such that you can use TODO comments without them leaking to users
  - Fixed directory reading support for read\_external\_files

  ## Component and styling
@@ -1649,7 +1660,7 @@
  - **Accessibility CLI command**: Run `mint a11y` to test your docs for accessibility issues
  - **Video responses in API playground**: API playground now supports displaying video response types
  - **API playground prefill**: New option to prefill API playground examples for faster testing
  - **Unauthenticated feedback**: For sites using partial authentication, users can now submit feedback without being authenticated
  - **Shiki theme support**: Shiki themes are now supported for code block styling
  - **Twoslash for code blocks**: TypeScript and JavaScript code blocks now support Twoslash for inline type information

@@ -1688,7 +1699,7 @@

  - Added support for Romanian and Czech languages in the documentation interface
  - Enhanced localization capabilities with complete translation coverage for new languages
  - Improved language selector functionality across all themes

  ## UI and user experience improvements

@@ -1724,7 +1735,7 @@
  - Fixed GitLab integration issues with larger repositories
  - Improved dashboard loading performance with optimized deployment queries
  - Fixed SVG path rendering issues in documentation
  - Fixed keyboard navigation in search and chat functionality
 </Update>

 <Update label="September 13, 2025" tags={["New releases","Improvements"]} rss={{ title:"Weekly Updates",description:"AI 404 suggestions, assistant web search with external sources, security enhancement, and reliability fixes" }}>
@@ -1747,7 +1758,7 @@
  - Security enhancement added to editor such that only users with `write permissions` for the connected git hosting repository can make changes
  - Fixed a bug where preview deployments wouldn't work for branches with `=` in the name
  - Fixed a bug where long branch names would overflow modals on preview deployment creations
  - Quality of life improvement where email query parameter will prefill the input on signup invitations
  - Fixed a bug where copying a page from the context menu was not working on safari

  ## API playground and navigation
@@ -1758,7 +1769,7 @@
  ## SEO and UI

  - Fixed a bug where favicons were not showing up in search engines by serving them from the same URL as the documentation site itself for each respective site
  - Fixed a bug where youtube embeds would flash in and out on load
  - Fixed a bug where expanding the feedback menu to include written responses would cause layout shift with the table of contents
  - Fixed a bug where text would leak above the topbar on the maple theme when a user dismissed the notification banner
  - Enhanced the Maple and Willow themes by adding login/logout buttons to the sidebar for easier access
@@ -1789,16 +1800,16 @@
  - Fixed a bug where Google was indexing raw `*.md` files because they were missing a `x-robots-tag noindex` header
  - Fixed a bug with OAuth on protected docs where it wouldn't redirect you back to your starting page once you completed the flow successfully
  - Fixed a bug on previews of auth protected docs where you weren't able to see the entire navigation bar
  - Bug fixes to how SVGs are handled with our new image CDN

  ## Component and styling enhancements

  - Added a new CSS selector for custom styles on `SidebarNavGroupDivider`
  - New regression tests for MDX defined API pages that have security defined on them will ensure a greater degree of stability

  ## Performance improvements

  - Performance improvement by moving the KaTeX CSS from cdnjs to our own CDN on Cloudfront for reduced latency
 </Update>

 <Update label="August 23, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Image layout fixes, auth enhancements, mobile nav improvements, and web editor stability" }}>
@@ -1810,13 +1821,13 @@
  ## Web editor and deployment enhancements

  - Fixed branch creation workflow in web editor to correctly navigate to and stay on newly created branches
  - Enhanced merge conflict dialog with proper escape functionality, no more page reloads required to dismiss conflicts
  - Optimized update workflow performance by cache-invalidating only changed pages during partial updates, reducing deployment times

  ## Authentication and navigation improvements

  - New support for authentication on custom subpaths, if you serve docs at `https://yourdomain.com/docs`, authentication now works seamlessly
  - Fixed sidebar display bug that incorrectly showed when only one link was configured
  - Comprehensive mobile navigation overhaul: centered buttons with proper margin/padding, improved spacing in dropdown menus, removed unnecessary dividers and margins for empty sections, and fixed Maple theme gap/padding issues

  ## Component and styling fixes
@@ -1828,7 +1839,7 @@

  - Enhanced logging system for update workflows enabling faster debugging and issue resolution
  - Fixed GitHub rate limiting for customers with 10\+ OpenAPI/AsyncAPI specs by switching from individual file fetching to repository cloning
  - Improved assistant reliability with backup LLM support, enhanced rate limit error handling, and more robust search tool functionality
 </Update>

 <Update label="August 16, 2025" tags={["Improvements"]} rss={{ title:"Weekly Updates",description:"Performance optimizations, LLM integrations, web editor polish, and API playground enhancements" }}>
@@ -1846,7 +1857,7 @@
  - Added Ruby support to API playground
  - We added a feature such that you can now [specify API pages using just your docs.json](/api-playground/openapi-setup#auto-populate-api-pages) without creating any new mdx files.
  - Support for [`webhook pages`](/api-playground/openapi-setup#webhooks) in docs navigation from OpenAPI specs
  - Optimized AI model context by removing anchor link specifications from markdown links when navigating to Anthropic, OpenAI, or other providers

  ## Web editor improvements

@@ -1890,8 +1901,8 @@
  ## Authentication improvements

  - Group-level public access: make entire page groups public via `docs.json` so you don’t need `public: true` on each page ([learn more](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level))
  - Support [`logoutURL in OAuth configuration`](https://mintlify.com/docs/authentication-personalization/authentication-setup#implementation-3) to delete upstream cookies and complete sign-out
  - On OAuth errors, users are redirected to your specified `logoutURL` to restart the auth flow
  - Fixed a flash of a 500 error during OAuth/JWT flows before the callback
  - Auto-strip `https://` from URLs in OAuth/JWT auth configuration to prevent misconfiguration

@@ -1911,7 +1922,7 @@

  - All image and video assets present in your docs repo are now served at the appropriate path on your domain. For example, if you have `/assets/marketing/my-logo.png` in your repo, it will be available at `https://mydocsurl.extension/assets/marketing/my-logo.png`.
  - Email field on login for the Mintlify dashboard now autofocuses so you can start typing immediately _(quality of life improvement)_
  - Both custom domains and subdomains in Redis for a performance improvement on navigation load times (~50ms latency reduction)
  - Added retry logic for PDF exports to improve reliability
  - Fixed cookie consent popup reappearing after acceptance or dismissal—first selection is now respected
  - Fixed copying a page to clipboard on Safari by specifying a MIME `type` in `navigator.write`
@@ -1921,8 +1932,8 @@
  - CLI bugfixes for windows and pnpm, plus CI tests to prevent regressions
  - Improved error logging output—a quality of life upgrade for our engineering team when debugging
  - Minor fixes to the broken-link CI action when `contentDirectory` files are missing
  - Fixed a regression caused by the auth-protected preview fixes from last week where the active tab was not being set correctly in the navigation UI
  - Fixed theme light background color not being applied to active tab icons
  - Fixed an issue where changing the auth type in the dashboard would update and then flip back to the previously saved type—now the new selection persists after saving
  - Internal DX improvements for enterprise customers with custom UI libraries—it's now easier for us to include your components and accommodate requests on shorter timelines
 </Update>
@@ -1937,7 +1948,7 @@

  ## API playground enhancements

  - Fixed `multipart/form-data` file upload functionality in the API playground
  - Fixed anchor link behavior so clicking them updates the URL without scrolling to top of page
  - Fixed anchor link issues in nested tabs

@@ -1952,7 +1963,7 @@

  - Made search feel more crisp and accurate by aborting debounced requests as you type
  - Resource provisions for a new CDN - expect image asset and page load times to improve soon
  - Fixed bugs for rendering complex Mermaid diagrams like GANTT charts
  - Fixed CLI bugs on Windows to improve stability and added tests to prevent regression

  ## Technical improvements
@@ -2018,11 +2029,11 @@
  Can now use `mint update` to update your CLI.
 </Update>

 <Update label="April 2025" tags={["New releases","Improvements"]}>
  ## Web Editor 3.0

  <Frame>
    ![Webeditor3 Jpe](/images/webeditor3.jpeg)
  </Frame>

  Overhauled usability in the WYSIWYG editor.
@@ -2039,13 +2050,13 @@

  - Fixed top margin for changelog components
  - Improved reliability of right click behavior
  - After clicking publish, you’ll stay on the same page instead of being brought to an empty state
  - Standardized colors in file icons
  - Improved reliability after selecting new branches several times in a row
  - Removed Diff mode
  - More consistency when creating a new folder from the dropdown
  - Fixed block quotes creating more block quotes when trying to deselect

  ## AI Translations in beta

  <Frame>
@@ -2067,7 +2078,7 @@
  ## MCP server generator

  <Frame>
    ![screenshot of MCP server generator](/images/changelog/mcpgenerator.png)
  </Frame>

  Generate MCP servers so that AI applications can interact with your docs or APIs. Written content is automatically generated as an MCP server, and you can generate an MCP server from your OpenAPI spec with one click. Check out [docs on getting started with MCP.](/ai/model-context-protocol)
@@ -2084,7 +2095,7 @@
  - Fixed icon style inconsistency for anchors without container
  - Improved styling nits for dashboard border for mobile-tablet-desktop responsiveness
  - Show code examples even when in simple mode for API playground
  - Support "command \+ k" shortcut for search in web editor
  - Codeblocks within callouts expand to fill the width of the callout area
 </Update>

@@ -2112,7 +2123,7 @@
  ```

  1. Delete your old `mint.json` file and push your changes

  ## CI Checks

  Automatically lint your docs to find broken links, discover spelling and grammar issues, or enforce writing styles with your own Vale config. Learn more in our [docs](deploy/ci).
@@ -2120,7 +2131,7 @@
  ## .md support for LLMs

  All documentation pages are now automatically available as plain Markdown files—just append `.md` to the URL. This makes it easier for LLMs to ingest individual pages from your documentation.

  ## More Themes

  <Frame>
@@ -2139,10 +2150,10 @@

  - [Guide to Technical Writing:](https://mintlify.com/guides/introduction) Best practices for writing technical documentation, including audience research, content types, and writing tips.
  - [Dropdown component](organize/navigation#dropdowns): Organize navigation with a dropdown, in addition to tabs and anchors.
  - [AI syntax fixer](https://x.com/ricardonunez_io/status/1892334887644123192): The web editor will catch if there’s a parsing error and use AI to suggest fixes.
 </Update>

 <Update label="January 2025" tags={["Improvements"]}>
  ## AI Assistant Improvements

  - New UI with dedicated chat page & pre-filled prompts
@@ -2153,7 +2164,7 @@
  ## Partial Authentication

  Customize access to any page or section of content depending on user permissions. Supports connecting with your own authentication system.

  ## Revamped API Playground

  We’ve overhauled the design and performance of the [API Playground](/api-playground/). Updates include:
@@ -2177,26 +2188,26 @@
  Make docs private by setting up authentication via JWT, OAuth, or a universal password. With this privacy, you can create an internal knowledge base or prevent competitors from seeing your docs.
 </Update>

 <Update label="November 2024">
  ## AI Writer

  <Frame>
    ![AI Assistant](/images/changelog/ai-assistant.jpg)
  </Frame>

  You can now ask AI to make changes to your docs, with the context of all existing documentation. Type in a prompt and the writer will propose changes by generating a pull request.

  ## GitLab Integration Upgrade

  We've improved our support for syncing with GitLab, such as enabling automated updates and preview deployments. Check out our [docs on GitLab](/deploy/gitlab) to get started.

  ## Web Editor

  <Frame>
    ![Web Editor](/images/changelog/webeditor.jpg)
  </Frame>

  We've revamped our web editor so that you can now update docs with a fully WYSIWYG experience, while syncing with markdown.

  Check out our [docs on getting started with Web Editor](/editor).

@@ -2210,7 +2221,7 @@

  ## Localization

  You can now localize your docs which operates similarly to versioning. Add a `locale` to a version and fixed content in Mintlify like "Was this page helpful?" will also match the locale.

  ### Quality Improvements

@@ -2226,7 +2237,7 @@
  <Frame>
    ![Changelog](/images/changelog/changelog.jpg)
  </Frame>

  ## Code Line Highlighting

  You can now highlight lines of code in your docs to emphasize and bring attention to important parts by adding a special comment after the language identifier. Use curly braces `{}` and specify line numbers or ranges separated by commas.
@@ -2258,7 +2269,7 @@
    "mode": "auto"
  }
  ```

  ## Advanced Footer

  <Frame>
@@ -2269,8 +2280,8 @@

  ## Filter search based on the current user

  When personalization is enabled, search results are now filtered based on the current logged in user so that they only see the relevant content.

  ## Custom Prompts for AI Chat

  You can now customize the prompts for the AI chat. Please reach out to [support](mailto:support@mintlify.com) if you'd like to customize the prompts.
@@ -2282,15 +2293,15 @@
  - Implemented the discovery login flow so that users that are members of multiple organizations can now switch between them.
  - Added login with Google OAuth
  - Added ability to add new deployment through dashboard settings.

  ## Bug Fixes

  - Can now use leading slashes in navigation.
  - Can now edit CSS & JS files in the web editor.
  - Fixed `suggestEdit` not showing up even when enabled.
  - Fixed keyboard navigation for Search and Chat such that you can now use the up and down arrow keys to navigate the results.
  - Don't allow search engines to crawl user-auth protected pages.
  - Revalidate the cache when an org is deleted.
  - We now use the Scalar OpenAPI parser to parse OpenAPI definitions which improves the performance, fixes parsing issues, and surfaces better error messages.
  - Top-level descriptions are now supported in API reference pages autogenerated from OpenAPI definitions.
  - Add in-line-style support for icons
@@ -2299,7 +2310,7 @@
  - Maintain scroll position when you click the back button in a browser.
 </Update>

 <Update label="September 2024">
  ## Custom Fonts

  <Frame>
@@ -2307,11 +2318,11 @@
  </Frame>

  Personalize the font of your docs to your own font hosted on a CDN or by choosing from Google fonts to match your docs with your brand.

  ## Images in Card components

  Add an `img` property to a card to display an image on the top of the card. Learn more about it [here](/components/cards#image-cards).

  ## Update Speed Performances

  <Frame>
@@ -2332,11 +2343,11 @@

  - App router migration in the dashboard.
  - Search analytics are now available in the dashboard.
  - Delete an org functionality has been added to the dashboard.
  - Shipped GitLab connection UI.
  - Fix incorrect analytics data.
  - Add-on's can now be directly purchased through the dashboard.

  ## Bug Fixes

  - Fixed a bug where the top bar would not stretch to the width of the screen when it's in custom mode and the sidebar layout is `sidenav`.
@@ -2344,15 +2355,15 @@

  ## More

  - **Troubleshooting for API pages**: API pages could be complicated so we listed common issues to help you sort them out quickly — [Read the docs](/api-playground/troubleshooting)
 </Update>

 <Update label="August 2024">
  ## OpenAPI Reference Pages

  - Endpoints defined by OpenAPI that are complex and recursive are now 98% smaller.
  - We now show [additionalProperties](https://swagger.io/docs/specification/data-models/dictionaries/) in OpenAPI pages.

  ## File Uploads in API Playground

  By default, API playground requests are proxied by Mintlify. Now you can use `disableProxy` to disable this behavior and support request types like file uploads.
@@ -2362,19 +2373,19 @@
  ## Mobile SEO improvements

  We've fixed the mobile layout of our docs so that they are more SEO-friendly - including adding proper aria tags to elements.

  ## Support Form

  We added a more detailed support form to the Mintlify dashboard. You can now submit a form to get in touch with us.

  ## Bug Fixes

  - Fixed a bug for the Segment integration functionality.
  - We now raise more granular error messages for GitHub permissions when interacting with the editor.
  - Fixed bugs where the navigation would not properly expand when a direct link was used.
 </Update>

 <Update label="July 2024">
  ## AI Widget

  <Frame>
@@ -2384,7 +2395,7 @@
  We introduced Mintlify Widget, an extension of your docs to answer your users' questions when and where they asked. You can add this AI-powered chatbot to any web page: your landing page, inside your product, or on your existing documentation pages.

  - [Read the blog announcement](https://mintlify.com/blog/widget)

  ## API Playground Code Example Sync

  When you browse API docs, the selected code example now syncs across your pages.
@@ -2394,7 +2405,7 @@
  Currently in beta, this feature summarizes common user questions and patterns into easy-to-digest reports with AI-powered suggestions on how to improve your product.
 </Update>

 <Update label="June 2024">
  ## Launch Week Highlights

  - Themes: Customize your styling with pre-configured themes. Just add the theme Quill, Prism, or Venus to your `docs.json` file and it'll update your docs styling.
@@ -2407,8 +2418,8 @@
 <Update label="May 2024">
  ## Okta SSO

  We now support sign-on via Okta SAML and OIDC.

  ## Mintlify REST API

  Programmatically trigger updates to your documentation.
@@ -2441,11 +2452,11 @@
  - CLI Error Detection: we now show the position of invalid frontmatter when there are parsing issues during local development
 </Update>

 <Update label="January 2024">
  ## Launch Week Highlights

  - Preview Deployments: When you create a pull request, we'll generate a unique link that shows a live preview of what your docs look like in prod. You can share this link with teammates.
  - Snippets V2: We now support fully reusable components and variables for snippets.
  - Open source MDX Engine: We've exposed two APIs—getCompiledMdx and MDXComponent—so you can access Mintlify markdown and code syntax highlighting. [Contributions to the project](https://github.com/mintlify/mdx) are welcome.
  - AI Chat Insights: Segment chat history by date and increase AI Chat quota from the dashboard, and see how often a specific query appears.
 </Update>
diff --git a/docs.json b/docs.json
@@ -248,6 +248,14 @@
                   "ai/skillmd",
                   "ai/model-context-protocol",
                   "optimize/search",
+                  {
+                    "group": "Mintlify Index",
+                    "pages": [
+                      "search-index/index",
+                      "search-index/connect",
+                      "search-index/mcp"
+                    ]
+                  },
                   "optimize/seo",
                   "ai/markdown-export",
                   "optimize/pdf-exports",
@@ -350,6 +358,16 @@
                   "api/assistant/get-page-content"
                 ]
               },
+              {
+                "group": "Mintlify Index",
+                "icon": "library",
+                "pages": [
+                  "api/search-index/introduction",
+                  "api/search-index/context",
+                  "api/search-index/search",
+                  "api/search-index/contents"
+                ]
+              },
               {
                 "group": "Analytics",
                 "icon": "chart-line",