Skip to content

Update from code changes: Agent feedback path validation - #7688

Merged
ethanpalm merged 2 commits into
mainfrom
mintlify/8254249b
Oct 8, 2026
Merged

ethanpalm merged 2 commits into
mainfrom
mintlify/8254249b

Conversation

@mintlify

@mintlify mintlify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Agent feedback now rejects submissions whose path doesn't match a page on the site. Mintlify normalizes the path first, then returns a 404 if no page matches. The feedback page now explains this requirement.

Changes

  • Added a paragraph to "How agent feedback works" saying the path must match an existing page, which path forms are accepted (relative path or full URL), and that unmatched paths return a 404.

Note

Low Risk
Documentation-only update describing existing or upcoming API behavior; no runtime or security impact in this diff.

Overview
Documents path validation for agent feedback via the MCP submit_feedback tool: the path must resolve to a site page or a redirect source, with flexible input (relative path or full URL) and normalization that ignores query strings, fragments, .md/.mdx extensions, and base path. Unmatched paths cause the tool to error and no feedback is recorded.

Clarifies that only accepted submissions are stored as unhelpful feedback in the dashboard (replacing wording that implied every submission was recorded).

Reviewed by Cursor Bugbot for commit 91a9e30. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
mintlify 🟢 Ready View Preview Oct 8, 2026, 5:22 PM

Redirect sources also count as known paths, and the MCP tool surfaces an
error rather than a raw 404 to the agent.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@ethanpalm
ethanpalm merged commit 8d29289 into main Oct 8, 2026
5 checks passed
@ethanpalm
ethanpalm deleted the mintlify/8254249b branch October 8, 2026 17:25

This branch was successfully deployed

1 active deployment
staging — 91a9e303 Deployed Oct 8, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant