Update OpenAPI Description (#53963)

Co-authored-by: Siara <[email protected]>

Author: docs-bot

src/github-apps/lib/config.json

@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "b1a9b605ce4d053e9554509fb4503109617a85f3"
+  "sha": "780e4964a55558c28e9bf35256510c3ad3882948"
 }

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

@@ -231406,12 +231406,13 @@
           {
             "name": "sort",
             "in": "query",
-            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.</p>",
+            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.\n<code>epss_percentage</code> sorts alerts by the Exploit Prediction Scoring System (EPSS) percentage.</p>",
             "schema": {
               "type": "string",
               "enum": [
                 "created",
-                "updated"
+                "updated",
+                "epss_percentage"
               ],
               "default": "created"
             }
@@ -233269,12 +233270,13 @@
           {
             "name": "sort",
             "in": "query",
-            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.</p>",
+            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.\n<code>epss_percentage</code> sorts alerts by the Exploit Prediction Scoring System (EPSS) percentage.</p>",
             "schema": {
               "type": "string",
               "enum": [
                 "created",
-                "updated"
+                "updated",
+                "epss_percentage"
               ],
               "default": "created"
             }
@@ -235157,12 +235159,13 @@
           {
             "name": "sort",
             "in": "query",
-            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.</p>",
+            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.\n<code>epss_percentage</code> sorts alerts by the Exploit Prediction Scoring System (EPSS) percentage.</p>",
             "schema": {
               "type": "string",
               "enum": [
                 "created",
-                "updated"
+                "updated",
+                "epss_percentage"
               ],
               "default": "created"
             }
@@ -596045,7 +596048,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Provides publicly available information about someone with a GitHub account. This method takes their durable user <code>ID</code> instead of their <code>login</code>, which can change over time.</p>\n<p>The <code>email</code> key in the following response is the publicly visible email address from your GitHub <a href=\"https://github.com/settings/profile\">profile page</a>. When setting up your profile, you can select a primary email address to be “public” which provides an email entry for this endpoint. If you do not set a public email address for <code>email</code>, then it will have a value of <code>null</code>. You only see publicly visible email addresses when authenticated with GitHub. For more information, see <a href=\"https://docs.github.com/rest/guides/getting-started-with-the-rest-api#authentication\">Authentication</a>.</p>\n<p>The Emails API enables you to list all of your email addresses, and toggle a primary email to be visible publicly. For more information, see \"<a href=\"https://docs.github.com/rest/users/emails\">Emails API</a>\".</p>",
+        "descriptionHTML": "<p>Provides publicly available information about someone with a GitHub account. This method takes their durable user <code>ID</code> instead of their <code>login</code>, which can change over time.</p>\n<p>If you are requesting information about an <a href=\"https://docs.github.com/enterprise-cloud@latest/admin/managing-iam/understanding-iam-for-enterprises/about-enterprise-managed-users\">Enterprise Managed User</a>, or a GitHub App bot that is installed in an organization that uses Enterprise Managed Users, your requests must be authenticated as a user or GitHub App that has access to the organization to view that account's information. If you are not authorized, the request will return a <code>404 Not Found</code> status.</p>\n<p>The <code>email</code> key in the following response is the publicly visible email address from your GitHub <a href=\"https://github.com/settings/profile\">profile page</a>. When setting up your profile, you can select a primary email address to be public which provides an email entry for this endpoint. If you do not set a public email address for <code>email</code>, then it will have a value of <code>null</code>. You only see publicly visible email addresses when authenticated with GitHub. For more information, see <a href=\"https://docs.github.com/rest/guides/getting-started-with-the-rest-api#authentication\">Authentication</a>.</p>\n<p>The Emails API enables you to list all of your email addresses, and toggle a primary email to be visible publicly. For more information, see <a href=\"https://docs.github.com/rest/users/emails\">Emails API</a>.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
@@ -597623,7 +597626,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Provides publicly available information about someone with a GitHub account.</p>\n<p>The <code>email</code> key in the following response is the publicly visible email address from your GitHub <a href=\"https://github.com/settings/profile\">profile page</a>. When setting up your profile, you can select a primary email address to be “public” which provides an email entry for this endpoint. If you do not set a public email address for <code>email</code>, then it will have a value of <code>null</code>. You only see publicly visible email addresses when authenticated with GitHub. For more information, see <a href=\"https://docs.github.com/rest/guides/getting-started-with-the-rest-api#authentication\">Authentication</a>.</p>\n<p>The Emails API enables you to list all of your email addresses, and toggle a primary email to be visible publicly. For more information, see \"<a href=\"https://docs.github.com/rest/users/emails\">Emails API</a>\".</p>",
+        "descriptionHTML": "<p>Provides publicly available information about someone with a GitHub account.</p>\n<p>If you are requesting information about an <a href=\"https://docs.github.com/enterprise-cloud@latest/admin/managing-iam/understanding-iam-for-enterprises/about-enterprise-managed-users\">Enterprise Managed User</a>, or a GitHub App bot that is installed in an organization that uses Enterprise Managed Users, your requests must be authenticated as a user or GitHub App that has access to the organization to view that account's information. If you are not authorized, the request will return a <code>404 Not Found</code> status.</p>\n<p>The <code>email</code> key in the following response is the publicly visible email address from your GitHub <a href=\"https://github.com/settings/profile\">profile page</a>. When setting up your profile, you can select a primary email address to be public which provides an email entry for this endpoint. If you do not set a public email address for <code>email</code>, then it will have a value of <code>null</code>. You only see publicly visible email addresses when authenticated with GitHub. For more information, see <a href=\"https://docs.github.com/rest/guides/getting-started-with-the-rest-api#authentication\">Authentication</a>.</p>\n<p>The Emails API enables you to list all of your email addresses, and toggle a primary email to be visible publicly. For more information, see <a href=\"https://docs.github.com/rest/users/emails\">Emails API</a>.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",

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

@@ -242888,12 +242888,13 @@
           {
             "name": "sort",
             "in": "query",
-            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.</p>",
+            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.\n<code>epss_percentage</code> sorts alerts by the Exploit Prediction Scoring System (EPSS) percentage.</p>",
             "schema": {
               "type": "string",
               "enum": [
                 "created",
-                "updated"
+                "updated",
+                "epss_percentage"
               ],
               "default": "created"
             }
@@ -244751,12 +244752,13 @@
           {
             "name": "sort",
             "in": "query",
-            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.</p>",
+            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.\n<code>epss_percentage</code> sorts alerts by the Exploit Prediction Scoring System (EPSS) percentage.</p>",
             "schema": {
               "type": "string",
               "enum": [
                 "created",
-                "updated"
+                "updated",
+                "epss_percentage"
               ],
               "default": "created"
             }
@@ -246639,12 +246641,13 @@
           {
             "name": "sort",
             "in": "query",
-            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.</p>",
+            "description": "<p>The property by which to sort the results.\n<code>created</code> means when the alert was created.\n<code>updated</code> means when the alert's state last changed.\n<code>epss_percentage</code> sorts alerts by the Exploit Prediction Scoring System (EPSS) percentage.</p>",
             "schema": {
               "type": "string",
               "enum": [
                 "created",
-                "updated"
+                "updated",
+                "epss_percentage"
               ],
               "default": "created"
             }
@@ -635060,7 +635063,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Provides publicly available information about someone with a GitHub account. This method takes their durable user <code>ID</code> instead of their <code>login</code>, which can change over time.</p>\n<p>The <code>email</code> key in the following response is the publicly visible email address from your GitHub Enterprise Cloud <a href=\"https://github.com/settings/profile\">profile page</a>. When setting up your profile, you can select a primary email address to be “public” which provides an email entry for this endpoint. If you do not set a public email address for <code>email</code>, then it will have a value of <code>null</code>. You only see publicly visible email addresses when authenticated with GitHub Enterprise Cloud. For more information, see <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/guides/getting-started-with-the-rest-api#authentication\">Authentication</a>.</p>\n<p>The Emails API enables you to list all of your email addresses, and toggle a primary email to be visible publicly. For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//rest/users/emails\">Emails API</a>\".</p>",
+        "descriptionHTML": "<p>Provides publicly available information about someone with a GitHub account. This method takes their durable user <code>ID</code> instead of their <code>login</code>, which can change over time.</p>\n<p>If you are requesting information about an <a href=\"https://docs.github.com/enterprise-cloud@latest//enterprise-cloud@latest/admin/managing-iam/understanding-iam-for-enterprises/about-enterprise-managed-users\">Enterprise Managed User</a>, or a GitHub App bot that is installed in an organization that uses Enterprise Managed Users, your requests must be authenticated as a user or GitHub App that has access to the organization to view that account's information. If you are not authorized, the request will return a <code>404 Not Found</code> status.</p>\n<p>The <code>email</code> key in the following response is the publicly visible email address from your GitHub Enterprise Cloud <a href=\"https://github.com/settings/profile\">profile page</a>. When setting up your profile, you can select a primary email address to be public which provides an email entry for this endpoint. If you do not set a public email address for <code>email</code>, then it will have a value of <code>null</code>. You only see publicly visible email addresses when authenticated with GitHub Enterprise Cloud. For more information, see <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/guides/getting-started-with-the-rest-api#authentication\">Authentication</a>.</p>\n<p>The Emails API enables you to list all of your email addresses, and toggle a primary email to be visible publicly. For more information, see <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/users/emails\">Emails API</a>.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
@@ -636638,7 +636641,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Provides publicly available information about someone with a GitHub account.</p>\n<p>The <code>email</code> key in the following response is the publicly visible email address from your GitHub Enterprise Cloud <a href=\"https://github.com/settings/profile\">profile page</a>. When setting up your profile, you can select a primary email address to be “public” which provides an email entry for this endpoint. If you do not set a public email address for <code>email</code>, then it will have a value of <code>null</code>. You only see publicly visible email addresses when authenticated with GitHub Enterprise Cloud. For more information, see <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/guides/getting-started-with-the-rest-api#authentication\">Authentication</a>.</p>\n<p>The Emails API enables you to list all of your email addresses, and toggle a primary email to be visible publicly. For more information, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//rest/users/emails\">Emails API</a>\".</p>",
+        "descriptionHTML": "<p>Provides publicly available information about someone with a GitHub account.</p>\n<p>If you are requesting information about an <a href=\"https://docs.github.com/enterprise-cloud@latest//enterprise-cloud@latest/admin/managing-iam/understanding-iam-for-enterprises/about-enterprise-managed-users\">Enterprise Managed User</a>, or a GitHub App bot that is installed in an organization that uses Enterprise Managed Users, your requests must be authenticated as a user or GitHub App that has access to the organization to view that account's information. If you are not authorized, the request will return a <code>404 Not Found</code> status.</p>\n<p>The <code>email</code> key in the following response is the publicly visible email address from your GitHub Enterprise Cloud <a href=\"https://github.com/settings/profile\">profile page</a>. When setting up your profile, you can select a primary email address to be public which provides an email entry for this endpoint. If you do not set a public email address for <code>email</code>, then it will have a value of <code>null</code>. You only see publicly visible email addresses when authenticated with GitHub Enterprise Cloud. For more information, see <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/guides/getting-started-with-the-rest-api#authentication\">Authentication</a>.</p>\n<p>The Emails API enables you to list all of your email addresses, and toggle a primary email to be visible publicly. For more information, see <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/users/emails\">Emails API</a>.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",