Skip to content
⌘K
InboxAsk a human

Mintlify

Updated by Amlesh Prusty

Last updated: 20 Nov 2026

Connect a Mintlify documentation project to Enterpret to analyze what visitors find confusing and what questions they ask. Enterpret imports individual page comments and groups each assistant conversation into a single feedback record.

Overview

At a glance

ItemMintlify
AccessMintlify Admin API key with read scope
Unit of importOne documentation project per connection
Scope chosen inProject ID in the Enterpret setup form
DirectionEnterpret pulls feedback from Mintlify
Default sync intervalEvery 15 minutes
History on first importThree months by default unless your workspace uses a different history setting. Eligible Trial and Growth workspaces use a 30-day history during workspace setup and choose their history afterward.
Record type and datePage comments use the submission date. Assistant conversations use the date of the first turn.
Not importedStandalone page votes, code snippet feedback, Mintlify agent feedback, search queries, and page views
Who is neededAn Enterpret workspace Admin or an Owner with integration management access, and a Mintlify user who can create an Admin API key
Limits100 analytics requests per Mintlify organization per hour, shared across its analytics API. See Limitations.

Prerequisites

Blocker: Workspace and API access. Your Enterpret workspace needs access to Mintlify in the integration catalog. If the card is missing, contact Enterpret Support to check eligibility. Mintlify requires a Pro or Enterprise plan for analytics API access.

You need:

  • In Enterpret: A workspace Admin or an Owner with access to manage integrations.
  • In Mintlify: Access to the documentation project and permission to create an Admin API key.
Value Where to find it Accepted format
API Key API keys in Mintlify Complete Admin API key beginning with mint_. Analytics access requires an Admin key.
Project ID Mintlify's API keys page Copy the ID for the intended project, for example demo-project.
Docs URL The base address where visitors read your docs An absolute URL starting with http:// or https://, for example https://docs.example.com. Omit individual page paths, query parameters, and anchors. Keep the base path if your docs are served under one.

Choose what to import

Each connection reads one Mintlify documentation project. Enter its Project ID in Enterpret. Enable contextual page feedback in that project to collect comments, and enable the docs assistant to collect its conversations. Enterpret imports both supported types from the selected project when they are available. Both types use the same history window.

Prepare Mintlify

  1. Open the API keys page in Mintlify.
  2. Create an Admin API key with read scope. Assistant keys start with mint_dsc_ and have access to a different set of endpoints.
  3. Select No expiration and leave the IP allowlist empty, as requested by the Enterpret setup form. If your organization requires either restriction, contact Enterpret Support to confirm which settings you can use before connecting.
  4. Copy the complete key and store it in your organization's approved secret manager.
  5. Copy the Project ID for the documentation project you want to import.

Connect Mintlify in Enterpret

Sign in to Enterpret and select the workspace you want to connect.

  1. Open the workspace menu and select Integrations.

    Select Integrations from the workspace menu.

  2. Select New Integration.

    Select New Integration on the Integrations page.

  3. Find Mintlify under Documentation or search for it by name.

    Search for Mintlify in Add New Integration.

  4. Select Continue on the Mintlify card, then choose Feedback Integration when asked to select an integration type.

    Choose Feedback Integration for Mintlify.

  5. Complete API Key, Project ID, and Docs URL. Use the complete key, the intended project ID, and the base address for your docs. The form below shows demo-project and https://docs.example.com as examples.

    Enter the API Key, Project ID, and Docs URL in the Mintlify feedback integration form.

  6. Under Describe the type of feedback being integrated, explain what the docs cover, who uses them, and what you want to learn. See Integration Descriptions.

    Describe the feedback, who writes it, and what you want to learn.

  7. In eligible Trial and Growth workspaces after workspace setup, use Start from to choose Today, 7 days ago, 14 days ago, or 30 days ago.

  8. In workspaces with feedback usage limits, users with permission to manage these limits can use Monthly limit. Choose No limit or Set a limit for the connection. The workspace's limits still apply.

    Choose a Start from date and a Monthly limit if those controls are available.

  9. Select Integrate.

    Select Integrate in the setup form.

When it worked: the setup form closes and the saved connection appears in Integrations. Enterpret checks access to the project during collection. Confirm the connection with a known record.

What Enterpret imports

One page comment or one assistant conversation becomes one feedback record.

Mintlify content Becomes in Enterpret Analyzed as text?
Contextual page comment A Page comment record with the documentation page link and the visitor's text. When the visitor selects a reason without writing a comment, Enterpret uses the reason as the feedback text. Yes
Docs assistant conversation An Assistant conversation record with the visitor's questions and the assistant's replies grouped in order. When Mintlify supplies an associated page, the source link opens that page. Yes
Page comment reason and contact email Metadata when supplied by the visitor No
Assistant response ratings, resolution status, response types, question categories, and cited document titles Metadata when supplied by Mintlify No

Not imported: standalone thumbs-only page votes, comments without a submission date or content, code snippet feedback, Mintlify agent feedback, search queries, and page views.

Fields by name:

Field in Enterpret Comes from Type
FeedbackType The kind of item imported, either Page comment or Assistant conversation Metadata
reason The reason the visitor selected when leaving a page comment Metadata
User Email The optional contact email the visitor submitted with a page comment Default field

See View & Manage Metadata for the metadata available on a record.

Sync and history

  • How new data arrives: Enterpret is scheduled to pull Mintlify feedback every 15 minutes. Data availability, collection limits, and processing can add time before records appear.
  • How far back the first import goes: Both feedback types use the same start date. The default is three months unless your workspace uses a different history setting. Eligible Trial and Growth workspaces import 30 days during workspace setup. After workspace setup, use Start from to choose today, 7 days, 14 days, or 30 days.
  • Later edits or deletions in Mintlify: Enterpret refreshes recent comments and conversations. Replies, ratings, or categories added to older conversations can be missing in Enterpret.

Limitations

LimitationDetail
Plan availabilityMintlify's analytics API requires Pro or Enterprise. Setup is available in Enterpret workspaces that have the Mintlify catalog card.
Supported feedbackEnterpret imports contextual page comments with a reason or text, and docs assistant conversations. Standalone page votes, code snippet feedback, Mintlify agent feedback, search queries, and page views stay in Mintlify.
Analytics quotaMintlify allows 100 analytics requests per organization per hour, shared by all its analytics endpoints. Imports can be delayed when the quota is reached.
HistoryBoth feedback types use the same start date. Contact Enterpret Support if you need to review what history can be imported for an existing connection.
Conversation linksThe source link opens the associated documentation page when Mintlify supplies one. Find the conversation transcript in Mintlify's analytics.
Changing project or docs addressThe Reauthorize form updates the key only. Contact Enterpret Support if you need to correct Project ID or Docs URL.

Verify the import

Check one known record

  1. In Mintlify, pick a page comment with text or a reason from the connected project and history window. If you collect assistant conversations, pick a conversation with a distinctive question as well.

  2. Open Feed in Enterpret and filter to Mintlify. Search for the comment or question text. If record preview is available, you can also open More source actions on the saved connection and select View all Records.

    Select View all Records from More source actions.

  3. Compare the text, date, and FeedbackType with the item in Mintlify. Open the source link to check that it leads to the expected documentation page. For an assistant conversation, compare the questions and replies in the record.

Check the status

Open Integrations and select Mintlify. Under Integration Details, check Status and any available error details.

Check Status in Integration Details. This example shows Active.

StatusMeaning
IngestingEnterpret is collecting the initial feedback. Records can arrive while this is still in progress.
ActiveEnterpret shows the connection as active. Check a known record to confirm it has finished processing.
Connection expiredEnterpret reported an authentication problem. Check the key and access settings, then review the troubleshooting steps.
Slow ingestion · RecoveringCollection is delayed. Check again after the next sync.
Ingestion blockedA rate limit is preventing collection. Open the status details for the next action.
PausedCollection is temporarily on hold. Feedback already imported stays available.
DisconnectedThe connection has stopped collecting feedback. Feedback already imported stays available.
DeletedThe connection and its imported feedback were deleted.

Manage the connection

On smaller screens, scroll horizontally to see all columns.

Operation Where Effect Reversible? Needs a person
Add a connection Integrations → New Integration → Mintlify Starts collecting eligible feedback from the selected project Collection can be stopped Yes, an Enterpret workspace Admin or Owner with integration access
Edit the feedback description Edit on the connection Updates the description for future processing Yes, edit it again Yes, an Enterpret workspace Admin or Owner with integration access
Replace the API key The connection menu → Reauthorize, or Reconnect on the expired connection Updates the API key and keeps the same project, docs address, and imported feedback Yes, by supplying another valid key Yes, someone who can manage the connection and obtain the new key
Correct the project or docs address Enterpret Support Support can advise on correcting the scope or page links and what to do with existing feedback Yes, Enterpret Support
Pause or resume collection Connection menu → Pause integration or Resume integration for connections that support pausing Pauses or restarts collection and keeps imported feedback Yes. The monthly limit can prevent immediate resumption. Yes, an Enterpret workspace Admin or Owner with integration access
Disconnect Connection menu → Disconnect integration Permanently stops collection and keeps imported feedback searchable No. Create a new connection to collect again. Yes, an Enterpret workspace Admin or Owner with integration access
Delete the connection and its feedback Connection menu → Delete Integration for workspaces with self-serve deletion Permanently removes the connection and its imported feedback No Yes, someone with integration deletion access

Add a connection

  1. Follow Connect Mintlify in Enterpret with the intended Project ID.
  2. Verify an imported record from that project before relying on the new connection.

Edit the feedback description

  1. Open Integrations and select the active Mintlify connection.
  2. Click Edit.
  3. Update Describe the type of feedback being integrated.
  4. Click Save Changes. See Integration Descriptions for how edits affect processing.

Replace the API key

  1. Create a replacement Mintlify Admin API key with read scope using the settings in Prepare Mintlify. For a planned rotation, keep the previous key active until you verify the replacement.

  2. Open the saved connection in Integrations, open More source actions, and choose Reauthorize. For an expired connection, you can also choose Reconnect. In workspaces with feedback consumption enabled, review the start point in the reconnect step before continuing.

    Select Reauthorize from More source actions.

  3. Paste the complete replacement key into API Key.

  4. Select Reauthorize.

    Enter a replacement key in API Key and select Reauthorize.

  5. After the next collection cycle, check the status and look for a new record. For a planned rotation, revoke the previous key in Mintlify once the new key works and you confirm no other project or integration uses the old key.

Correct the project or docs address

  1. Ask Enterpret Support to review the saved connection before you add a replacement.
  2. Send the saved and intended project ID or base URL. Tell Support whether you need to keep the feedback already imported.

Pause or resume collection

  1. Open the Mintlify connection menu.
  2. Select Pause integration to stop collection temporarily. Confirm the pause.
  3. Select Resume integration to restart. If you see Monthly feedback limit reached, ask your workspace admin to review the limit.

Disconnect

  1. Open the Mintlify connection menu and select Disconnect integration.
  2. Confirm Disconnect integration to stop future imports permanently. Previously imported feedback stays searchable.

Delete the connection and its feedback

  1. In a workspace with self-serve deletion, open the Mintlify connection menu and select Delete Integration.
  2. Review the impact on existing feedback and analyses.
  3. Confirm Delete Integration to permanently remove the connection and its imported feedback. This action cannot be undone.

Troubleshooting

Before connecting

Symptom Cause Fix
Mintlify is missing from the catalog The workspace may lack access, or your role may lack permission to add integrations. Ask a workspace Admin to check the catalog. If the card is still missing, contact Enterpret Support to check eligibility.
You cannot create an Admin API key Your Mintlify plan or permissions may lack analytics API access. Confirm that the Mintlify organization is on Pro or Enterprise and ask a user who can create Admin API keys to prepare the key.

While connecting

Symptom Cause Fix
Integrate is disabled A required value is missing, the feedback description needs attention, or a history or limit setting needs attention. Complete API Key, Project ID, and Docs URL. Review the description feedback and any message under Start from or Monthly limit.
The form rejects the docs address Docs URL needs an absolute web address without a query or fragment. Enter the base address where visitors read the docs, such as https://docs.example.com.

After connecting

Symptom Cause Fix
Connection expired The analytics request was rejected. Causes can include an incomplete, expired, or revoked key, insufficient scope, or an IP allowlist. Check the complete Admin API key and its read access. Reauthorize if you need to replace the key. If it remains valid and the status persists, contact Enterpret Support to review the connection.
The connection is saved, but feedback is missing The project ID may be wrong, the project may have no supported feedback in the history window, or the initial sync may still be processing. Check the saved status and project ID. Confirm that the source record is eligible, then check again after the next sync.
Page links open the wrong address Docs URL is used to build links to pages visitors commented on. Check the saved base URL. Send Enterpret Support the correct base URL and an example affected page.
A later assistant reply or rating is missing Changes to older conversations can fall outside the refresh window. Check again after the next sync. If it is still missing, send Support the conversation date and an example.
Counts differ from Mintlify Mintlify's totals can include standalone votes and other analytics. Collection and processing can also affect the count. Compare the same date range and supported feedback types. See Missing records and count differences.

Contacting Support

Email Enterpret Support. Include the workspace, Project ID, Docs URL, the displayed status or error, and an example timestamp or affected page. Never send your API key.

Analyze this feedback

Sample prompt: Review Mintlify feedback from the last 30 days. Separate page comments and assistant conversations, identify recurring documentation gaps and questions, and cite representative records and pages.

Use Scheduled Agent Automations to send a recurring summary through Slack or email.

Revision history

DateChange
20 Nov 2026Added instructions and screenshots for connecting a Mintlify project, verifying imported feedback, and replacing the API key.