From e60f25124de57123ad6f9b04456a5cc5c246fc94 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 12 Nov 2026 01:13:36 +0000 Subject: [PATCH 1/2] Document how groups filter the search, page content and assistant APIs Co-authored-by: brandon --- discovery-openapi.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/discovery-openapi.json b/discovery-openapi.json index b4242d4d7..71cf1631c 100644 --- a/discovery-openapi.json +++ b/discovery-openapi.json @@ -242,7 +242,7 @@ "items": { "type": "string" }, - "description": "Optional array of group identifiers to filter results. The assistant can retrieve protected content unless you pass `groups`. Mintlify doesn't verify group membership, so your backend must choose the groups for each user." + "description": "Optional groups of the user the assistant answers for. When you pass `groups`, the assistant reads public pages, pages open to any signed-in user, and pages restricted to at least one of these groups. An empty array means a signed-in user with no groups. If you omit `groups`, the assistant can retrieve all content, including protected pages. If Visibility section filtering is on for your site, `` sections for signed-in readers or for specific groups follow the same rules. Contact support to turn it on. Mintlify doesn't verify group membership, so your backend must choose the groups for each user." } }, "description": "Optional filter criteria for the search." @@ -362,7 +362,7 @@ "items": { "type": "string" }, - "description": "Optional documentation groups that narrow results. The assistant API key can read all content, including protected pages. If omitted or empty, includes protected pages in results. Mintlify doesn't verify group membership, so your backend must choose the groups for each user. On password-protected deployments, `groups` doesn't restrict anything." + "description": "Optional groups of the user you're reading for. When you pass groups, the content includes public pages, pages open to any signed-in user, and pages restricted to at least one of these groups. If you omit `groups` or pass an empty array, the API key can read all content, including protected pages. If Visibility section filtering is on for your site, an empty array means a signed-in user with no groups, and `` sections the user can't see are removed from the page. Contact support to turn it on. Mintlify doesn't verify group membership, so your backend must choose the groups for each user. On password-protected deployments, `groups` doesn't restrict anything." } } } @@ -492,7 +492,7 @@ "items": { "type": "string" }, - "description": "Optional documentation groups that narrow results. The assistant API key can read all content, including protected pages. If omitted or empty, includes protected pages in results. Mintlify doesn't verify group membership, so your backend must choose the groups for each user. On password-protected deployments, `groups` doesn't restrict anything." + "description": "Optional groups of the user you're searching for. When you pass `groups`, results include public pages, pages open to any signed-in user, and pages restricted to at least one of these groups. An empty array means a signed-in user with no groups. If you omit `groups`, the API key can read all content, including protected pages. If Visibility section filtering is on for your site, `` sections for signed-in readers or for specific groups follow the same rules. Contact support to turn it on. Mintlify doesn't verify group membership, so your backend must choose the groups for each user. On password-protected deployments, `groups` doesn't restrict anything." } } } From 83031d66bcd8ef5d4ce76b4ef694502fd7037a91 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 12 Nov 2026 04:16:57 +0000 Subject: [PATCH 2/2] Describe groups filtering as on for every site Co-authored-by: brandon --- discovery-openapi.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/discovery-openapi.json b/discovery-openapi.json index 71cf1631c..4deab2407 100644 --- a/discovery-openapi.json +++ b/discovery-openapi.json @@ -242,7 +242,7 @@ "items": { "type": "string" }, - "description": "Optional groups of the user the assistant answers for. When you pass `groups`, the assistant reads public pages, pages open to any signed-in user, and pages restricted to at least one of these groups. An empty array means a signed-in user with no groups. If you omit `groups`, the assistant can retrieve all content, including protected pages. If Visibility section filtering is on for your site, `` sections for signed-in readers or for specific groups follow the same rules. Contact support to turn it on. Mintlify doesn't verify group membership, so your backend must choose the groups for each user." + "description": "Optional groups of the user the assistant answers for. When you pass `groups`, the assistant reads public pages, pages open to any signed-in user, and pages restricted to at least one of these groups. An empty array means a signed-in user with no groups. If you omit `groups`, the assistant can retrieve all content, including protected pages. `` sections for signed-in readers or for specific groups follow the same rules. Mintlify doesn't verify group membership, so your backend must choose the groups for each user." } }, "description": "Optional filter criteria for the search." @@ -362,7 +362,7 @@ "items": { "type": "string" }, - "description": "Optional groups of the user you're reading for. When you pass groups, the content includes public pages, pages open to any signed-in user, and pages restricted to at least one of these groups. If you omit `groups` or pass an empty array, the API key can read all content, including protected pages. If Visibility section filtering is on for your site, an empty array means a signed-in user with no groups, and `` sections the user can't see are removed from the page. Contact support to turn it on. Mintlify doesn't verify group membership, so your backend must choose the groups for each user. On password-protected deployments, `groups` doesn't restrict anything." + "description": "Optional groups of the user you're reading for. When you pass groups, the content includes public pages, pages open to any signed-in user, and pages restricted to at least one of these groups, and `` sections the user can't see are removed from the page. An empty array means a signed-in user with no groups. If you omit `groups`, the API key can read all content, including protected pages. Mintlify doesn't verify group membership, so your backend must choose the groups for each user. On password-protected deployments, `groups` doesn't restrict anything." } } } @@ -492,7 +492,7 @@ "items": { "type": "string" }, - "description": "Optional groups of the user you're searching for. When you pass `groups`, results include public pages, pages open to any signed-in user, and pages restricted to at least one of these groups. An empty array means a signed-in user with no groups. If you omit `groups`, the API key can read all content, including protected pages. If Visibility section filtering is on for your site, `` sections for signed-in readers or for specific groups follow the same rules. Contact support to turn it on. Mintlify doesn't verify group membership, so your backend must choose the groups for each user. On password-protected deployments, `groups` doesn't restrict anything." + "description": "Optional groups of the user you're searching for. When you pass `groups`, results include public pages, pages open to any signed-in user, and pages restricted to at least one of these groups. An empty array means a signed-in user with no groups. If you omit `groups`, the API key can read all content, including protected pages. `` sections for signed-in readers or for specific groups follow the same rules. Mintlify doesn't verify group membership, so your backend must choose the groups for each user. On password-protected deployments, `groups` doesn't restrict anything." } } }