Update OpenAPI Description (#55380)

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

Author: docs-bot

src/github-apps/lib/config.json

@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "a3b90207333d17877bcbab612a4163337ed7148c"
+  "sha": "8af3e59120fdf6294e2d385bdae74b39fa824da5"
 }

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

@@ -144111,7 +144111,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Triggers GitHub to rerequest an existing check run, without pushing new code to a repository. This endpoint will trigger the <a href=\"https://docs.github.com/webhooks/event-payloads/#check_run\"><code>check_run</code> webhook</a> event with the action <code>rerequested</code>. When a check run is <code>rerequested</code>, the <code>status</code> of the check suite it belongs to is reset to <code>queued</code> and the <code>conclusion</code> is cleared. The check run itself is not updated. GitHub apps recieving the <a href=\"https://docs.github.com/webhooks/event-payloads/#check_run\"><code>check_run</code> webhook</a> with the <code>rerequested</code> action should then decide if the check run should be reset or updated and call the <a href=\"https://docs.github.com/rest/checks/runs#update-a-check-run\">update <code>check_run</code> endpoint</a> to update the check_run if desired.</p>\n<p>For more information about how to re-run GitHub Actions jobs, see \"<a href=\"https://docs.github.com/rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run\">Re-run a job from a workflow run</a>\".</p>\n<p>OAuth apps and personal access tokens (classic) cannot use this endpoint.</p>",
+        "descriptionHTML": "<p>Triggers GitHub to rerequest an existing check run, without pushing new code to a repository. This endpoint will trigger the <a href=\"https://docs.github.com/webhooks/event-payloads/#check_run\"><code>check_run</code> webhook</a> event with the action <code>rerequested</code>. When a check run is <code>rerequested</code>, the <code>status</code> of the check suite it belongs to is reset to <code>queued</code> and the <code>conclusion</code> is cleared. The check run itself is not updated. GitHub apps recieving the <a href=\"https://docs.github.com/webhooks/event-payloads/#check_run\"><code>check_run</code> webhook</a> with the <code>rerequested</code> action should then decide if the check run should be reset or updated and call the <a href=\"https://docs.github.com/rest/checks/runs#update-a-check-run\">update <code>check_run</code> endpoint</a> to update the check_run if desired.</p>\n<p>For more information about how to re-run GitHub Actions jobs, see \"<a href=\"https://docs.github.com/rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run\">Re-run a job from a workflow run</a>\".</p>",
         "statusCodes": [
           {
             "httpStatusCode": "201",
@@ -154379,7 +154379,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Triggers GitHub to rerequest an existing check suite, without pushing new code to a repository. This endpoint will trigger the <a href=\"https://docs.github.com/webhooks/event-payloads/#check_suite\"><code>check_suite</code> webhook</a> event with the action <code>rerequested</code>. When a check suite is <code>rerequested</code>, its <code>status</code> is reset to <code>queued</code> and the <code>conclusion</code> is cleared.</p>\n<p>OAuth apps and personal access tokens (classic) cannot use this endpoint.</p>",
+        "descriptionHTML": "<p>Triggers GitHub to rerequest an existing check suite, without pushing new code to a repository. This endpoint will trigger the <a href=\"https://docs.github.com/webhooks/event-payloads/#check_suite\"><code>check_suite</code> webhook</a> event with the action <code>rerequested</code>. When a check suite is <code>rerequested</code>, its <code>status</code> is reset to <code>queued</code> and the <code>conclusion</code> is cleared.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "201",
@@ -243433,6 +243433,27 @@
               "type": "string"
             }
           },
+          {
+            "name": "has",
+            "in": "query",
+            "description": "<p>Filters the list of alerts based on whether the alert has a patch. If specified, only alerts with a patch will be returned.\nMultiple <code>has</code> filters can be chained to check if multiple properties are present.</p>",
+            "schema": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "patch"
+                    ]
+                  }
+                }
+              ]
+            }
+          },
           {
             "name": "scope",
             "in": "query",
@@ -245345,6 +245366,27 @@
               "type": "string"
             }
           },
+          {
+            "name": "has",
+            "in": "query",
+            "description": "<p>Filters the list of alerts based on whether the alert has a patch. If specified, only alerts with a patch will be returned.\nMultiple <code>has</code> filters can be chained to check if multiple properties are present.</p>",
+            "schema": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "patch"
+                    ]
+                  }
+                }
+              ]
+            }
+          },
           {
             "name": "scope",
             "in": "query",
@@ -247282,6 +247324,27 @@
               "type": "string"
             }
           },
+          {
+            "name": "has",
+            "in": "query",
+            "description": "<p>Filters the list of alerts based on whether the alert has a patch. If specified, only alerts with a patch will be returned.\nMultiple <code>has</code> filters can be chained to check if multiple properties are present.</p>",
+            "schema": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "patch"
+                    ]
+                  }
+                }
+              ]
+            }
+          },
           {
             "name": "scope",
             "in": "query",

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

@@ -118107,7 +118107,7 @@
           {
             "name": "advanced_security_product",
             "in": "query",
-            "description": "<p>The security feature to get GitHub Advanced Security active committers for.</p>",
+            "description": "<p>The security product to get GitHub Advanced Security active committers for. This parameter is required if you have puchased standalone Code Scanning or Secret Protection products to specify which one you want to get the committer information for, otherwise it is not required.</p>",
             "required": false,
             "schema": {
               "type": "string",
@@ -153527,7 +153527,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Triggers GitHub to rerequest an existing check run, without pushing new code to a repository. This endpoint will trigger the <a href=\"https://docs.github.com/enterprise-cloud@latest//webhooks/event-payloads/#check_run\"><code>check_run</code> webhook</a> event with the action <code>rerequested</code>. When a check run is <code>rerequested</code>, the <code>status</code> of the check suite it belongs to is reset to <code>queued</code> and the <code>conclusion</code> is cleared. The check run itself is not updated. GitHub apps recieving the <a href=\"https://docs.github.com/enterprise-cloud@latest//webhooks/event-payloads/#check_run\"><code>check_run</code> webhook</a> with the <code>rerequested</code> action should then decide if the check run should be reset or updated and call the <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#update-a-check-run\">update <code>check_run</code> endpoint</a> to update the check_run if desired.</p>\n<p>For more information about how to re-run GitHub Actions jobs, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run\">Re-run a job from a workflow run</a>\".</p>\n<p>OAuth apps and personal access tokens (classic) cannot use this endpoint.</p>",
+        "descriptionHTML": "<p>Triggers GitHub to rerequest an existing check run, without pushing new code to a repository. This endpoint will trigger the <a href=\"https://docs.github.com/enterprise-cloud@latest//webhooks/event-payloads/#check_run\"><code>check_run</code> webhook</a> event with the action <code>rerequested</code>. When a check run is <code>rerequested</code>, the <code>status</code> of the check suite it belongs to is reset to <code>queued</code> and the <code>conclusion</code> is cleared. The check run itself is not updated. GitHub apps recieving the <a href=\"https://docs.github.com/enterprise-cloud@latest//webhooks/event-payloads/#check_run\"><code>check_run</code> webhook</a> with the <code>rerequested</code> action should then decide if the check run should be reset or updated and call the <a href=\"https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#update-a-check-run\">update <code>check_run</code> endpoint</a> to update the check_run if desired.</p>\n<p>For more information about how to re-run GitHub Actions jobs, see \"<a href=\"https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run\">Re-run a job from a workflow run</a>\".</p>",
         "statusCodes": [
           {
             "httpStatusCode": "201",
@@ -163843,7 +163843,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>Triggers GitHub to rerequest an existing check suite, without pushing new code to a repository. This endpoint will trigger the <a href=\"https://docs.github.com/enterprise-cloud@latest//webhooks/event-payloads/#check_suite\"><code>check_suite</code> webhook</a> event with the action <code>rerequested</code>. When a check suite is <code>rerequested</code>, its <code>status</code> is reset to <code>queued</code> and the <code>conclusion</code> is cleared.</p>\n<p>OAuth apps and personal access tokens (classic) cannot use this endpoint.</p>",
+        "descriptionHTML": "<p>Triggers GitHub to rerequest an existing check suite, without pushing new code to a repository. This endpoint will trigger the <a href=\"https://docs.github.com/enterprise-cloud@latest//webhooks/event-payloads/#check_suite\"><code>check_suite</code> webhook</a> event with the action <code>rerequested</code>. When a check suite is <code>rerequested</code>, its <code>status</code> is reset to <code>queued</code> and the <code>conclusion</code> is cleared.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "201",
@@ -256753,6 +256753,27 @@
               "type": "string"
             }
           },
+          {
+            "name": "has",
+            "in": "query",
+            "description": "<p>Filters the list of alerts based on whether the alert has a patch. If specified, only alerts with a patch will be returned.\nMultiple <code>has</code> filters can be chained to check if multiple properties are present.</p>",
+            "schema": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "patch"
+                    ]
+                  }
+                }
+              ]
+            }
+          },
           {
             "name": "scope",
             "in": "query",
@@ -258665,6 +258686,27 @@
               "type": "string"
             }
           },
+          {
+            "name": "has",
+            "in": "query",
+            "description": "<p>Filters the list of alerts based on whether the alert has a patch. If specified, only alerts with a patch will be returned.\nMultiple <code>has</code> filters can be chained to check if multiple properties are present.</p>",
+            "schema": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "patch"
+                    ]
+                  }
+                }
+              ]
+            }
+          },
           {
             "name": "scope",
             "in": "query",
@@ -260602,6 +260644,27 @@
               "type": "string"
             }
           },
+          {
+            "name": "has",
+            "in": "query",
+            "description": "<p>Filters the list of alerts based on whether the alert has a patch. If specified, only alerts with a patch will be returned.\nMultiple <code>has</code> filters can be chained to check if multiple properties are present.</p>",
+            "schema": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "patch"
+                    ]
+                  }
+                }
+              ]
+            }
+          },
           {
             "name": "scope",
             "in": "query",
@@ -281318,7 +281381,7 @@
           {
             "name": "advanced_security_product",
             "in": "query",
-            "description": "<p>The security feature to get GitHub Advanced Security active committers for.</p>",
+            "description": "<p>The security product to get GitHub Advanced Security active committers for. This parameter is required if you have puchased standalone Code Scanning or Secret Protection products to specify which one you want to get the committer information for, otherwise it is not required.</p>",
             "required": false,
             "schema": {
               "type": "string",