From 0e2d12e7bb73f18e5702d7d0378c22b9a4775d4b Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 8 Apr 2026 21:53:21 +0000
Subject: [PATCH] Document agent feedback for markdown exports

Generated-By: mintlify-agent
---
 ai/markdown-export.mdx | 19 +++++++++++++++++++
 optimize/feedback.mdx  |  1 +
 2 files changed, 20 insertions(+)

diff --git a/ai/markdown-export.mdx b/ai/markdown-export.mdx
index 836225c8e..92222bbfb 100644
--- a/ai/markdown-export.mdx
+++ b/ai/markdown-export.mdx
@@ -27,3 +27,22 @@ curl -H "Accept: text/markdown" https://mintlify.com/docs/ai/markdown-export
 ## Keyboard shortcut
 
 Press <kbd>Command</kbd> + <kbd>C</kbd> (<kbd>Ctrl</kbd> + <kbd>C</kbd> on Windows) to copy a page as Markdown to your clipboard.
+
+## Agent feedback
+
+When agent feedback is enabled, Markdown exports include an embedded feedback instruction block that lets AI agents programmatically report documentation issues. Agents can submit feedback by sending a POST request to the endpoint URL included in the Markdown output.
+
+The feedback instruction block appears at the top of every Markdown export and contains the endpoint URL and expected request format:
+
+```bash
+curl -X POST https://your-domain.com/_mintlify/feedback/{subdomain}/agent-feedback \
+  -H "Content-Type: application/json" \
+  -d '{"path": "/current-page-path", "feedback": "Description of the issue"}'
+```
+
+| Field      | Type   | Required | Description                              |
+| ---------- | ------ | -------- | ---------------------------------------- |
+| `path`     | string | Yes      | The page path the feedback is about.     |
+| `feedback` | string | Yes      | A description of the documentation issue. |
+
+Agent feedback appears alongside other feedback in your [feedback dashboard](https://dashboard.mintlify.com/products/analytics/v2/feedback). See [Feedback](/optimize/feedback) for more information on managing feedback.
diff --git a/optimize/feedback.mdx b/optimize/feedback.mdx
index 4c6e2b072..7f52e9847 100644
--- a/optimize/feedback.mdx
+++ b/optimize/feedback.mdx
@@ -53,6 +53,7 @@ The feedback tab displays information according to the [feedback add-ons](https:
 - **Raise issues**: Allow users to create GitHub issues directly from your documentation. Only available for public GitHub repositories.
 - **Contextual feedback**: Free form feedback about the content of a page.
 - **Code snippet feedback**: Feedback specifically on code snippets.
+- **Agent feedback**: Feedback submitted by AI agents when consuming [Markdown exports](/ai/markdown-export#agent-feedback). When enabled, Markdown exports include an endpoint that agents can use to report documentation issues.
 
 ## Collect email addresses