Agent feedback

[ethanpalm]

Documentation changes

Closes https://linear.app/mintlify/issue/DOC-345/agent-feedback

---

For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

• Code examples work as written
• Commands and configurations are correct
• Links resolve to the right destinations
• Prerequisites and requirements are accurate

✅ Clarity and completeness

• Instructions are clear and easy to follow
• Steps are in logical order
• Nothing important is missing
• Examples help illustrate the concepts

✅ User experience

• A new user could follow these docs successfully
• Common gotchas or edge cases are addressed
• Error messages or troubleshooting guidance is helpful

---

Note

Medium Risk
Primarily documentation/OpenAPI updates, but changes to the published FeedbackResponse schema (enums and required fields) may affect downstream codegen clients or integrations that rely on the spec.

Overview
Adds agent feedback documentation: explains that Markdown exports can include an appended <AgentInstructions> block and that agents submit feedback by POSTing page path + feedback text.

Updates the analytics feedback API docs/spec to support filtering and returning source=agent, and clarifies the response union by adding per-source descriptions and tightening required fields for contextual (helpful, contact) and code_snippet (code, filename, lang) entries. Also extends the main Feedback docs with beta notes, enablement steps, dashboard behavior, and API retrieval guidance.

^{Reviewed by Cursor Bugbot for commit 42a1c69. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify-development]

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

Project	Status	Preview	Updated (UTC)
userauth	🟡 Building	–	Apr 16, 2026, 10:03 PM

[mintlify]

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

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Apr 16, 2026, 10:06 PM