Update OpenAPI Description (#35588)

Co-authored-by: Matt Pollard <mattpollard@users.noreply.github.com>

src/github-apps/lib/config.json

@@ -1,3 +1,3 @@
 {
-  "sha": "92d400e8ed58bbcce276b0a086c2ae9112960f67"
+  "sha": "65adf4dce261054a39b3bd3616f2678c870525b3"
 }

src/rest/data/fpt-2022-11-28/schema.json

@@ -339116,8 +339116,12 @@
                       "format": "uri"
                     },
                     "exclude": {
+                      "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                       "type": "array",
-                      "items": {}
+                      "items": {
+                        "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                        "type": "string"
+                      }
                     }
                   },
                   "required": [
@@ -341131,8 +341135,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -343111,8 +343119,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -348060,8 +348072,12 @@
                       "format": "uri"
                     },
                     "exclude": {
+                      "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                       "type": "array",
-                      "items": {}
+                      "items": {
+                        "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                        "type": "string"
+                      }
                     }
                   },
                   "required": [
@@ -350068,8 +350084,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -352041,8 +352061,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -355746,7 +355770,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Enables or disables the specified security feature for all repositories in an organization.</p>\n<p>To use this endpoint, you must be an organization owner or be member of a team with the security manager role.\nA token with the 'write:org' scope is also required.</p>\n<p>GitHub Apps must have the <code>organization_administration:write</code> permission to use this endpoint.</p>\n<p>For more information, see \"<a href=\"https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization\">Managing security managers in your organization</a>.\"</p>",
+        "descriptionHTML": "<p>Enables or disables the specified security feature for all eligible repositories in an organization.</p>\n<p>To use this endpoint, you must be an organization owner or be member of a team with the security manager role.\nA token with the 'write:org' scope is also required.</p>\n<p>GitHub Apps must have the <code>organization_administration:write</code> permission to use this endpoint.</p>\n<p>For more information, see \"<a href=\"https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization\">Managing security managers in your organization</a>.\"</p>",
         "statusCodes": [
           {
             "httpStatusCode": "204",
@@ -501649,7 +501673,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>List all of the teams across all of the organizations to which the authenticated user belongs. This method requires <code>user</code>, <code>repo</code>, or <code>read:org</code> <a href=\"https://docs.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/\">scope</a> when authenticating via <a href=\"https://docs.github.com/apps/building-oauth-apps/\">OAuth</a>.</p>",
+        "descriptionHTML": "<p>List all of the teams across all of the organizations to which the authenticated user belongs. This method requires <code>user</code>, <code>repo</code>, or <code>read:org</code> <a href=\"https://docs.github.com/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/\">scope</a> when authenticating via <a href=\"https://docs.github.com/apps/building-oauth-apps/\">OAuth</a>. When using a fine-grained personal access token, the resource owner of the token <a href=\"https://docs.github.com/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token#fine-grained-personal-access-tokens\">must be a single organization</a>, and have at least read-only member organization permissions. The response payload only contains the teams from a single organization when using a fine-grained personal access token.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",

src/rest/data/ghae/schema.json

@@ -245920,8 +245920,12 @@
                       "format": "uri"
                     },
                     "exclude": {
+                      "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                       "type": "array",
-                      "items": {}
+                      "items": {
+                        "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                        "type": "string"
+                      }
                     }
                   },
                   "required": [
@@ -247850,8 +247854,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -249745,8 +249753,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -252751,8 +252763,12 @@
                       "format": "uri"
                     },
                     "exclude": {
+                      "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                       "type": "array",
-                      "items": {}
+                      "items": {
+                        "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                        "type": "string"
+                      }
                     }
                   },
                   "required": [
@@ -254674,8 +254690,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -384033,7 +384053,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>List all of the teams across all of the organizations to which the authenticated user belongs. This method requires <code>user</code>, <code>repo</code>, or <code>read:org</code> <a href=\"https://docs.github.com/github-ae@latest/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/\">scope</a> when authenticating via <a href=\"https://docs.github.com/github-ae@latest/apps/building-oauth-apps/\">OAuth</a>.</p>",
+        "descriptionHTML": "<p>List all of the teams across all of the organizations to which the authenticated user belongs. This method requires <code>user</code>, <code>repo</code>, or <code>read:org</code> <a href=\"https://docs.github.com/github-ae@latest/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/\">scope</a> when authenticating via <a href=\"https://docs.github.com/github-ae@latest/apps/building-oauth-apps/\">OAuth</a>. When using a fine-grained personal access token, the resource owner of the token <a href=\"https://docs.github.com/github-ae@latest/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token#fine-grained-personal-access-tokens\">must be a single organization</a>, and have at least read-only member organization permissions. The response payload only contains the teams from a single organization when using a fine-grained personal access token.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",

src/rest/data/ghec-2022-11-28/schema.json

@@ -352303,8 +352303,12 @@
                       "format": "uri"
                     },
                     "exclude": {
+                      "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                       "type": "array",
-                      "items": {}
+                      "items": {
+                        "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                        "type": "string"
+                      }
                     }
                   },
                   "required": [
@@ -354318,8 +354322,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -356298,8 +356306,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -361247,8 +361259,12 @@
                       "format": "uri"
                     },
                     "exclude": {
+                      "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                       "type": "array",
-                      "items": {}
+                      "items": {
+                        "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                        "type": "string"
+                      }
                     }
                   },
                   "required": [
@@ -363255,8 +363271,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -365228,8 +365248,12 @@
                     "format": "uri"
                   },
                   "exclude": {
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "description": "Allowed values that can be passed to the exclude parameter. The array can include any of: `\"repositories\"`.",
+                      "type": "string"
+                    }
                   }
                 },
                 "required": [
@@ -369517,7 +369541,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Enables or disables the specified security feature for all repositories in an organization.</p>\n<p>To use this endpoint, you must be an organization owner or be member of a team with the security manager role.\nA token with the 'write:org' scope is also required.</p>\n<p>GitHub Apps must have the <code>organization_administration:write</code> permission to use this endpoint.</p>\n<p>For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization\">Managing security managers in your organization</a>.\"</p>",
+        "descriptionHTML": "<p>Enables or disables the specified security feature for all eligible repositories in an organization.</p>\n<p>To use this endpoint, you must be an organization owner or be member of a team with the security manager role.\nA token with the 'write:org' scope is also required.</p>\n<p>GitHub Apps must have the <code>organization_administration:write</code> permission to use this endpoint.</p>\n<p>For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization\">Managing security managers in your organization</a>.\"</p>",
         "statusCodes": [
           {
             "httpStatusCode": "204",
@@ -520813,7 +520837,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>List all of the teams across all of the organizations to which the authenticated user belongs. This method requires <code>user</code>, <code>repo</code>, or <code>read:org</code> <a href=\"https://docs.github.com/enterprise-cloud@latest//apps/building-oauth-apps/understanding-scopes-for-oauth-apps/\">scope</a> when authenticating via <a href=\"https://docs.github.com/enterprise-cloud@latest//apps/building-oauth-apps/\">OAuth</a>.</p>",
+        "descriptionHTML": "<p>List all of the teams across all of the organizations to which the authenticated user belongs. This method requires <code>user</code>, <code>repo</code>, or <code>read:org</code> <a href=\"https://docs.github.com/enterprise-cloud@latest//apps/building-oauth-apps/understanding-scopes-for-oauth-apps/\">scope</a> when authenticating via <a href=\"https://docs.github.com/enterprise-cloud@latest//apps/building-oauth-apps/\">OAuth</a>. When using a fine-grained personal access token, the resource owner of the token <a href=\"https://docs.github.com/enterprise-cloud@latest//authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token#fine-grained-personal-access-tokens\">must be a single organization</a>, and have at least read-only member organization permissions. The response payload only contains the teams from a single organization when using a fine-grained personal access token.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",