diff --git a/discovery-openapi.json b/discovery-openapi.json
index b4242d4d7..4deab2407 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. `<Visibility>` 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 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, and `<Visibility>` 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 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. `<Visibility>` 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."
                       }
                     }
                   }