From 82d4246f890b1f9fdc91e4d31f7515305511db30 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Wed, 8 Apr 2026 03:04:45 +0000
Subject: [PATCH] Add agent as a feedback source type in analytics docs

Generated-By: mintlify-agent
---
 analytics.openapi.json             | 13 +++++++++----
 api/analytics/feedback-by-page.mdx |  2 +-
 api/analytics/feedback.mdx         |  3 ++-
 optimize/feedback.mdx              |  1 +
 4 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/analytics.openapi.json b/analytics.openapi.json
index dfe124c69..2ea8ecc28 100644
--- a/analytics.openapi.json
+++ b/analytics.openapi.json
@@ -62,9 +62,10 @@
                       "enum": [
                         "code_snippet",
                         "contextual",
+                        "agent",
                         "thumbs_only"
                       ],
-                      "description": "Where the feedback originated. `code_snippet` is feedback on a code block, `contextual` is page-level feedback, `thumbs_only` is a thumbs up/down vote."
+                      "description": "Where the feedback originated. `code_snippet` is feedback on a code block, `contextual` is page-level feedback, `agent` is feedback submitted by a Mintlify agent, `thumbs_only` is a thumbs up/down vote."
                     },
                     "status": {
                       "type": "string",
@@ -116,9 +117,10 @@
                       "enum": [
                         "code_snippet",
                         "contextual",
+                        "agent",
                         "thumbs_only"
                       ],
-                      "description": "Where the feedback originated. `code_snippet` is feedback on a code block, `contextual` is page-level feedback, `thumbs_only` is a thumbs up/down vote."
+                      "description": "Where the feedback originated. `code_snippet` is feedback on a code block, `contextual` is page-level feedback, `agent` is feedback submitted by a Mintlify agent, `thumbs_only` is a thumbs up/down vote."
                     },
                     "status": {
                       "type": "string",
@@ -183,9 +185,10 @@
                       "enum": [
                         "code_snippet",
                         "contextual",
+                        "agent",
                         "thumbs_only"
                       ],
-                      "description": "Where the feedback originated. `code_snippet` is feedback on a code block, `contextual` is page-level feedback, `thumbs_only` is a thumbs up/down vote."
+                      "description": "Where the feedback originated. `code_snippet` is feedback on a code block, `contextual` is page-level feedback, `agent` is feedback submitted by a Mintlify agent, `thumbs_only` is a thumbs up/down vote."
                     },
                     "status": {
                       "type": "string",
@@ -662,6 +665,7 @@
               "enum": [
                 "code_snippet",
                 "contextual",
+                "agent",
                 "thumbs_only"
               ],
               "description": "Filter by feedback source"
@@ -788,7 +792,8 @@
               "type": "string",
               "enum": [
                 "code_snippet",
-                "contextual"
+                "contextual",
+                "agent"
               ],
               "description": "Filter by feedback source"
             },
diff --git a/api/analytics/feedback-by-page.mdx b/api/analytics/feedback-by-page.mdx
index d08f97a23..38cc6f620 100644
--- a/api/analytics/feedback-by-page.mdx
+++ b/api/analytics/feedback-by-page.mdx
@@ -13,6 +13,6 @@ Use this endpoint to export user feedback aggregated by documentation page path.
 
 Filter feedback by:
 - **Date range**: Use `dateFrom` and `dateTo` to limit results to a specific time period
-- **Source**: Filter by `code_snippet` or `contextual` feedback types
+- **Source**: Filter by `code_snippet`, `contextual`, or `agent` feedback types
 - **Status**: Filter by status values like `pending`, `in_progress`, `resolved`, or `dismissed`
 
diff --git a/api/analytics/feedback.mdx b/api/analytics/feedback.mdx
index a700507d0..efc2dd179 100644
--- a/api/analytics/feedback.mdx
+++ b/api/analytics/feedback.mdx
@@ -15,7 +15,7 @@ Paginate through results using the `cursor` parameter returned in the response.
 
 Filter feedback by:
 - **Date range**: Use `dateFrom` and `dateTo` to limit results to a specific time period
-- **Source**: Filter by `code_snippet` or `contextual` feedback types
+- **Source**: Filter by `code_snippet`, `contextual`, or `agent` feedback types
 - **Status**: Filter by status values like `pending`, `in_progress`, `resolved`, or `dismissed`
 
 ## Response types
@@ -24,3 +24,4 @@ The response contains different feedback types based on the source:
 
 - **Contextual feedback**: Includes `helpful` boolean and optional `contact` email
 - **Code snippet feedback**: Includes `code`, `filename`, and `lang` fields
+- **Agent feedback**: Feedback submitted by a Mintlify agent
diff --git a/optimize/feedback.mdx b/optimize/feedback.mdx
index 4c6e2b072..0819d328f 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 a Mintlify agent on behalf of users.
 
 ## Collect email addresses