> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wolfia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mintlify Integration for Documentation Sync

> Connect your Mintlify documentation site to Wolfia and keep your public or private docs answerable in your knowledge base.

## Overview

Teams that publish their product and security documentation on Mintlify can make every page answerable in Wolfia without exporting or copying anything. This works for public docs sites and for private sites that sit behind a login: Wolfia reads your pages through Mintlify's own API using an assistant API key you provide, so content that a normal web crawler can never reach still lands in your knowledge base.

Access is read-only. Wolfia never changes anything on your documentation site.

## Before you start

Setup goes fastest when you have three things ready:

* **You are an Admin in Wolfia.** Only Admins can connect integrations.
* **Your Mintlify assistant API key.** In your Mintlify dashboard, open **API keys** and copy the assistant key. It starts with `mint_dsc_`. The assistant key can only read and search documentation, so it is the safest key to share.
* **Your docs domain.** The domain your documentation is served from, for example `docs.example.com`.

<Note>
  If your documentation is private, also note which documentation groups your reviewers can access. Wolfia can only read the pages those groups can see.
</Note>

## Step 1: Connect Mintlify

<Steps>
  <Step title="Start the connection in Wolfia">
    Navigate to **Knowledge Hub** in the left sidebar, find the **Mintlify** integration, and click **Connect**.

    <img src="https://mintcdn.com/wolfia/MCOEGJdAVc7tGm5H/images/integrations/mintlify/mintlify-connect-card.png?fit=max&auto=format&n=MCOEGJdAVc7tGm5H&q=85&s=485874e765641d50491fa0bd0897c529" alt="The Knowledge Hub integrations list with the Mintlify card" width="3600" height="1972" data-path="images/integrations/mintlify/mintlify-connect-card.png" />
  </Step>

  <Step title="Enter your docs domain and assistant API key">
    Enter the domain your documentation is served from and paste your assistant API key.

    <img src="https://mintcdn.com/wolfia/MCOEGJdAVc7tGm5H/images/integrations/mintlify/mintlify-connection-dialog.png?fit=max&auto=format&n=MCOEGJdAVc7tGm5H&q=85&s=0b0012d418934b2376f5168aa9cd79ac" alt="The Mintlify connection dialog with the docs domain and assistant API key fields" width="3600" height="1972" data-path="images/integrations/mintlify/mintlify-connection-dialog.png" />
  </Step>

  <Step title="Optional: scope what syncs">
    Expand **Advanced options** to reveal two optional fields:

    1. **Documentation groups** applies when your docs are private. Enter the group names, separated by commas, and Wolfia reads the pages those groups can access.
    2. **Manual page paths** overrides automatic page discovery. When set, only the paths you list sync, and previously synced pages that are no longer listed are removed. Leave this empty to sync everything Wolfia discovers.
  </Step>

  <Step title="Save and let the first sync run">
    Click **Connect**. Wolfia discovers your pages from your documentation site's index and starts syncing them right away. Pages appear in your knowledge base as they finish processing.
  </Step>
</Steps>

## Step 2: Review your synced pages

On the **Mintlify** page in the Knowledge Hub you can see every synced page, when it last updated, and its processing status. From here you can also:

* **Sync now** runs a sync immediately instead of waiting for the next scheduled one.
* **Manage** updates the connection. Your saved domain, groups, and page paths are prefilled. Enter the assistant API key again each time you save.
* **Disconnect** removes the integration and every page it synced.

## How syncing works

Wolfia syncs your documentation automatically every day. Each sync:

* Picks up new pages, updates changed pages, and removes pages deleted from your site.
* Skips pages that have not changed, so repeat syncs stay fast.
* Cleans navigation clutter from each page so your knowledge base holds the substance of the page.

You can trigger a sync at any time with **Sync now** in the top right of the Mintlify page. The same **Sync now** action is available on the detail pages of your other connected integrations too.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connection is rejected with a message about the docs domain">
    Enter only the domain, such as `docs.example.com`. Wolfia strips `https://` automatically, and only publicly reachable documentation domains are accepted.
  </Accordion>

  <Accordion title="Pages are missing after a sync">
    If your docs are private, check the **Documentation groups** on the connection. Wolfia can only read pages those groups can access. If you use **Manual page paths**, remember it is an override: only the listed paths sync.
  </Accordion>

  <Accordion title="The sync shows a failed status">
    A failed sync usually means the assistant API key expired or was revoked, or the docs domain changed. Open **Manage**, confirm the domain, and enter a current assistant API key. Then click **Sync now**.
  </Accordion>

  <Accordion title="Where do I find the assistant API key?">
    In your Mintlify dashboard under **API keys**. Use the assistant key that starts with `mint_dsc_`. It can only read and search documentation, which is all Wolfia needs. Admin keys are never required.
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={2}>
  <Card title="GitHub integration" icon="github" href="/how-to/github-integration">
    Sync documentation and policies straight from your repositories.
  </Card>

  <Card title="Confluence integration" icon="confluence" href="/how-to/confluence-integration">
    Bring your Confluence spaces into the knowledge base.
  </Card>

  <Card title="Adding knowledge" icon="book-open" href="/how-to/adding-knowledge">
    All the ways to add content to your knowledge base.
  </Card>

  <Card title="Customizing AI answers" icon="wand-magic-sparkles" href="/how-to/customizing-ai">
    Shape how Wolfia answers from your synced content.
  </Card>
</CardGroup>
