Skip to content

Document how groups filter the search, page content and assistant APIs - #8428

Open
brandonmcconnell wants to merge 2 commits into
mainfrom
cursor/document-groups-field-6f15
Open

brandonmcconnell wants to merge 2 commits into
mainfrom
cursor/document-groups-field-6f15

Conversation

@brandonmcconnell

@brandonmcconnell brandonmcconnell commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Documentation changes

Updates the groups field descriptions in discovery-openapi.json. They render on the Search documentation, Get page content and Create assistant message API pages.

  • Search: the old text said an empty array includes protected pages. It doesn't: [] means a signed-in user with no groups. Fixed.
  • Page content: [] now also means a signed-in user with no groups (mintlify/server#10969), not "everything".
  • All three:
    • What passing groups includes.
    • That omitting groups returns everything.
    • That <Visibility> sections for signed-in readers or specific groups follow the same rules.

I checked the behavior against buildFilters, getPage and the section filter in mintlify/server#10969. The es, fr and zh copies are left for the translation pipeline.

Screenshots

Local mint dev preview at 2x. The before shots are from main, the after shots from this branch. The changed field is outlined in red.

Get page content: groups

Before After
Get page content groups field before Get page content groups field after

Search documentation: filter.groups

Before After
Search filter.groups field before Search filter.groups field after

Create assistant message: filter.groups

Before After
Assistant filter.groups field before Assistant filter.groups field after

Closes


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
  • Content follows the style guide

✅ User experience

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

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

Note

Low Risk
Documentation-only OpenAPI description updates; no code or security behavior changes in this PR.

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

Co-authored-by: brandon <brandon@dreamthinkbuild.com>
@mintlify

mintlify Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Nov 12, 2026, 4:17 AM

Co-authored-by: brandon <brandon@dreamthinkbuild.com>

This branch was successfully deployed

1 active deployment
staging — 83031d66 Deployed Nov 12, 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.

2 participants