Decouple search and assistant endpoints

[ethanpalm]

Documentation changes

Closes https://linear.app/mintlify/issue/DOC-385/move-search-endpoint-out-of-assistant-docs

---

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

Low Risk
Documentation and OpenAPI description-only changes with no runtime or API behavior changes.

Overview
Splits search/page-content endpoints out of the Assistant section in docs.json into a dedicated Search nav group, leaving Assistant with only create-message. The API reference group icon changes from file-json to file-braces.

Updates api/introduction.mdx to treat assistant chat vs documentation retrieval as separate use cases, broaden assistant-key scope wording (messages, search, page content), and clarify billing: search and get-page-content do not consume credits; only assistant messages can incur overages. Security copy is tightened so credit-risk warnings focus on the message endpoint while still recommending proxying all assistant-key traffic.

OpenAPI (discovery-openapi.json) adds the no-credits note on search and page-content operations and corrects the get-page-content path parameter description to reference the search response’s path field (not page).

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

[mintiebot]

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

Project	Status	Preview	Updated (UTC)
tomee	🟢 Ready	View Preview	Jul 22, 2026, 10:34 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[mintlify]

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

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Jul 22, 2026, 10:34 PM