@octokit/openapi 5.6.1 → 5.6.5

package/generated/ghes-3.2.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "5.6.1",
+    "version": "5.6.5",
     "title": "GitHub's official OpenAPI spec + Octokit extension",
     "description": "OpenAPI specs from https://github.com/github/rest-api-description with the 'x-octokit' extension required by the Octokit SDKs",
     "license": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -808,6 +808,7 @@
           }
         },
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": {
@@ -817,7 +818,8 @@
                     "type": "string",
                     "description": "The [distinguished name](https://www.ldap.com/ldap-dns-and-rdns) (DN) of the LDAP entry to map to a team."
                   }
-                }
+                },
+                "required": ["ldap_dn"]
               },
               "example": {
                 "ldap_dn": "cn=Enterprise Ops,ou=teams,dc=github,dc=com"
@@ -903,6 +905,7 @@
           }
         },
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": {
@@ -912,7 +915,8 @@
                     "type": "string",
                     "description": "The [distinguished name](https://www.ldap.com/ldap-dns-and-rdns) (DN) of the LDAP entry to map to a team."
                   }
-                }
+                },
+                "required": ["ldap_dn"]
               },
               "example": { "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com" }
             }
@@ -991,6 +995,7 @@
           }
         },
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": {
@@ -2095,6 +2100,7 @@
           }
         },
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": {
@@ -2810,6 +2816,7 @@
         },
         "parameters": [{ "$ref": "#/components/parameters/client-id" }],
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": {
@@ -2819,7 +2826,8 @@
                     "type": "string",
                     "description": "The OAuth access token used to authenticate to the GitHub API."
                   }
-                }
+                },
+                "required": ["access_token"]
               },
               "example": {
                 "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a"
@@ -3895,6 +3903,7 @@
         "tags": ["enterprise-admin"],
         "operationId": "enterprise-admin/set-announcement",
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": { "$ref": "#/components/schemas/announcement" }
@@ -4599,6 +4608,7 @@
         "parameters": [{ "$ref": "#/components/parameters/enterprise" }],
         "responses": { "204": { "description": "Response" } },
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": { "$ref": "#/components/schemas/selected-actions" },
@@ -4617,9 +4627,7 @@
           "category": "enterprise-admin",
           "subcategory": "actions"
         },
-        "x-octokit": {
-          "diff": { "api.github.com.json": { "type": "changed" } }
-        }
+        "x-octokit": {}
       }
     },
     "/enterprises/{enterprise}/actions/runner-groups": {
@@ -6630,15 +6638,19 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": false,
+          "category": "issues",
           "previews": [
+            {
+              "required": false,
+              "name": "machine-man",
+              "note": "If an issue event is created via a GitHub App, the response will include the `performed_via_github_app` object with\tinformation about the GitHub App. For more information, see the [related blog\tpost](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access).\nTo receive the `performed_via_github_app` object in the response, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.machine-man-preview\n```"
+            },
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "issues",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -7486,9 +7498,7 @@
           "category": "orgs",
           "subcategory": null
         },
-        "x-octokit": {
-          "diff": { "api.github.com.json": { "type": "changed" } }
-        }
+        "x-octokit": {}
       }
     },
     "/orgs/{org}/actions/permissions": {
@@ -7779,9 +7789,7 @@
           "category": "actions",
           "subcategory": "permissions"
         },
-        "x-octokit": {
-          "diff": { "api.github.com.json": { "type": "changed" } }
-        }
+        "x-octokit": {}
       }
     },
     "/orgs/{org}/actions/runner-groups": {
@@ -7965,6 +7973,7 @@
           { "$ref": "#/components/parameters/runner-group-id" }
         ],
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": {
@@ -7979,7 +7988,8 @@
                     "type": "string",
                     "enum": ["selected", "all", "private"]
                   }
-                }
+                },
+                "required": ["name"]
               },
               "example": {
                 "name": "Expensive hardware runners",
@@ -8845,6 +8855,7 @@
           { "$ref": "#/components/parameters/secret-name" }
         ],
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": {
@@ -8855,7 +8866,8 @@
                     "description": "An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the `visibility` is set to `selected`. You can add and remove individual repositories using the [Set selected repositories for an organization secret](https://docs.github.com/enterprise-server@3.2/rest/reference/actions#set-selected-repositories-for-an-organization-secret) and [Remove selected repository from an organization secret](https://docs.github.com/enterprise-server@3.2/rest/reference/actions#remove-selected-repository-from-an-organization-secret) endpoints.",
                     "items": { "type": "integer" }
                   }
-                }
+                },
+                "required": ["selected_repository_ids"]
               },
               "example": { "selected_repository_ids": [64780797] }
             }
@@ -9731,15 +9743,19 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": false,
+          "category": "issues",
           "previews": [
+            {
+              "required": false,
+              "name": "machine-man",
+              "note": "If an issue event is created via a GitHub App, the response will include the `performed_via_github_app` object with\tinformation about the GitHub App. For more information, see the [related blog\tpost](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access).\nTo receive the `performed_via_github_app` object in the response, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.machine-man-preview\n```"
+            },
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "issues",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -11185,15 +11201,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "discussions",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "teams",
-          "subcategory": "discussions"
+          ]
         },
         "x-octokit": {}
       },
@@ -11257,15 +11273,15 @@
           "triggersNotification": true,
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "discussions",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "teams",
-          "subcategory": "discussions"
+          ]
         },
         "x-octokit": {}
       }
@@ -11301,15 +11317,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "discussions",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "teams",
-          "subcategory": "discussions"
+          ]
         },
         "x-octokit": {}
       },
@@ -11365,15 +11381,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "discussions",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "teams",
-          "subcategory": "discussions"
+          ]
         },
         "x-octokit": {}
       },
@@ -11444,15 +11460,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "discussion-comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "teams",
-          "subcategory": "discussion-comments"
+          ]
         },
         "x-octokit": {}
       },
@@ -11509,15 +11525,15 @@
           "triggersNotification": true,
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "discussion-comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "teams",
-          "subcategory": "discussion-comments"
+          ]
         },
         "x-octokit": {}
       }
@@ -11558,15 +11574,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "discussion-comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "teams",
-          "subcategory": "discussion-comments"
+          ]
         },
         "x-octokit": {}
       },
@@ -11623,15 +11639,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "discussion-comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "teams",
-          "subcategory": "discussion-comments"
+          ]
         },
         "x-octokit": {}
       },
@@ -11718,15 +11734,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       },
@@ -11800,15 +11815,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -11834,15 +11848,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -11903,15 +11916,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       },
@@ -11984,15 +11996,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": false,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -12017,15 +12028,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -13845,23 +13855,21 @@
           "304": { "$ref": "#/components/responses/not_modified" },
           "401": { "$ref": "#/components/responses/requires_authentication" },
           "403": { "$ref": "#/components/responses/forbidden" },
-          "410": { "$ref": "#/components/responses/gone" },
-          "415": { "$ref": "#/components/responses/preview_header_missing" }
+          "410": { "$ref": "#/components/responses/gone" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-21",
+          "deprecationDate": "2020-02-26",
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-21",
-          "deprecationDate": "2020-02-26",
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -13917,8 +13925,7 @@
               "note": "The Codes of Conduct API is currently available for developers to preview.\n\nTo access the API during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.scarlet-witch-preview+json\n```"
             }
           ],
-          "category": "repos",
-          "subcategory": null
+          "category": "repos"
         },
         "x-octokit": {}
       },
@@ -14536,9 +14543,7 @@
           "category": "actions",
           "subcategory": "permissions"
         },
-        "x-octokit": {
-          "diff": { "api.github.com.json": { "type": "changed" } }
-        }
+        "x-octokit": {}
       }
     },
     "/repos/{owner}/{repo}/actions/runners": {
@@ -18488,6 +18493,7 @@
           { "$ref": "#/components/parameters/repo" }
         ],
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": {
@@ -19577,15 +19583,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "repos",
-          "subcategory": "comments"
+          ]
         },
         "x-octokit": {}
       }
@@ -19622,15 +19628,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "repos",
-          "subcategory": "comments"
+          ]
         },
         "x-octokit": {}
       },
@@ -19771,21 +19777,19 @@
             },
             "headers": { "Link": { "$ref": "#/components/headers/link" } }
           },
-          "404": { "$ref": "#/components/responses/not_found" },
-          "415": { "$ref": "#/components/responses/preview_header_missing" }
+          "404": { "$ref": "#/components/responses/not_found" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       },
@@ -19860,15 +19864,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -19893,15 +19896,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -20071,15 +20073,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "repos",
-          "subcategory": "comments"
+          ]
         },
         "x-octokit": {}
       },
@@ -21125,15 +21127,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "deployments",
           "previews": [
             {
               "required": false,
               "name": "ant-man",
               "note": "The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. Please see the [blog post](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) for full details.\n\nTo access the API during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.ant-man-preview+json\n```"
             }
-          ],
-          "category": "repos",
-          "subcategory": "deployments"
+          ]
         },
         "x-octokit": {}
       },
@@ -21272,15 +21274,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "deployments",
           "previews": [
             {
               "required": false,
               "name": "ant-man",
               "note": "The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. Please see the [blog post](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) for full details.\n\nTo access the API during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.ant-man-preview+json\n```"
             }
-          ],
-          "category": "repos",
-          "subcategory": "deployments"
+          ]
         },
         "x-octokit": {}
       }
@@ -21317,15 +21319,20 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "deployments",
           "previews": [
+            {
+              "required": false,
+              "name": "flash",
+              "note": "New features in the Deployments API on GitHub are currently available during a public beta. Please see the [blog post](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/) for full details.\n\nTo access the new `environment` parameter, the two new values for the `state` parameter (`in_progress` and `queued`), and use `auto_inactive` on production deployments during the public beta period, you must provide the following custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.flash-preview+json\n```"
+            },
             {
               "required": false,
               "name": "ant-man",
               "note": "The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. Please see the [blog post](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) for full details.\n\nTo access the API during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.ant-man-preview+json\n```"
             }
-          ],
-          "category": "repos",
-          "subcategory": "deployments"
+          ]
         },
         "x-octokit": {}
       },
@@ -21398,6 +21405,8 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "deployments",
           "previews": [
             {
               "required": false,
@@ -21409,9 +21418,7 @@
               "name": "ant-man",
               "note": "The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. Please see the [blog post](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) for full details.\n\nTo access the API during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.ant-man-preview+json\n```"
             }
-          ],
-          "category": "repos",
-          "subcategory": "deployments"
+          ]
         },
         "x-octokit": {}
       },
@@ -21438,7 +21445,7 @@
                 "properties": {
                   "state": {
                     "type": "string",
-                    "description": "The state of the status. Can be one of `error`, `failure`, `inactive`, `in_progress`, `queued` `pending`, or `success`. **Note:** To use the `inactive` state, you must provide the [`application/vnd.github.ant-man-preview+json`](https://docs.github.com/enterprise-server@3.2/rest/overview/api-previews#enhanced-deployments) custom media type. To use the `in_progress` and `queued` states, you must provide the [`application/vnd.github.flash-preview+json`](https://docs.github.com/enterprise-server@3.2/rest/overview/api-previews#deployment-statuses) custom media type. When you set a transient deployment to `inactive`, the deployment will be shown as `destroyed` in GitHub.",
+                    "description": "The state of the status. Can be one of `error`, `failure`, `inactive`, `in_progress`, `queued` `pending`, or `success`. **Note:** To use the `inactive` state, you must provide the [`application/vnd.github.ant-man-preview+json`](https://docs.github.com/enterprise-server@3.2/rest/overview/api-previews#enhanced-deployments) custom media type. When you set a transient deployment to `inactive`, the deployment will be shown as `destroyed` in GitHub.",
                     "enum": [
                       "error",
                       "failure",
@@ -21466,7 +21473,7 @@
                   },
                   "environment": {
                     "type": "string",
-                    "description": "Name for the target deployment environment, which can be changed when setting a deploy status. For example, `production`, `staging`, or `qa`. **Note:** This parameter requires you to use the [`application/vnd.github.flash-preview+json`](https://docs.github.com/enterprise-server@3.2/rest/overview/api-previews#deployment-statuses) custom media type.",
+                    "description": "Name for the target deployment environment, which can be changed when setting a deploy status. For example, `production`, `staging`, or `qa`.",
                     "enum": ["production", "staging", "qa"]
                   },
                   "environment_url": {
@@ -21476,7 +21483,7 @@
                   },
                   "auto_inactive": {
                     "type": "boolean",
-                    "description": "Adds a new `inactive` status to all prior non-transient, non-production environment deployments with the same repository and `environment` name as the created status's deployment. An `inactive` status is only added to deployments that had a `success` state. Default: `true`  \n**Note:** To add an `inactive` status to `production` environments, you must use the [`application/vnd.github.flash-preview+json`](https://docs.github.com/enterprise-server@3.2/rest/overview/api-previews#deployment-statuses) custom media type.  \n**Note:** This parameter requires you to use the [`application/vnd.github.ant-man-preview+json`](https://docs.github.com/enterprise-server@3.2/rest/overview/api-previews#enhanced-deployments) custom media type."
+                    "description": "Adds a new `inactive` status to all prior non-transient, non-production environment deployments with the same repository and `environment` name as the created status's deployment. An `inactive` status is only added to deployments that had a `success` state. Default: `true` \n**Note:** This parameter requires you to use the [`application/vnd.github.ant-man-preview+json`](https://docs.github.com/enterprise-server@3.2/rest/overview/api-previews#enhanced-deployments) custom media type."
                   }
                 },
                 "required": ["state"]
@@ -21515,6 +21522,8 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "deployments",
           "previews": [
             {
               "required": false,
@@ -21526,9 +21535,7 @@
               "name": "ant-man",
               "note": "The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. Please see the [blog post](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) for full details.\n\nTo access the API during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.ant-man-preview+json\n```"
             }
-          ],
-          "category": "repos",
-          "subcategory": "deployments"
+          ]
         },
         "x-octokit": {}
       }
@@ -21568,12 +21575,13 @@
               }
             }
           },
-          "404": { "$ref": "#/components/responses/not_found" },
-          "415": { "$ref": "#/components/responses/preview_header_missing" }
+          "404": { "$ref": "#/components/responses/not_found" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "repos",
+          "subcategory": "deployments",
           "previews": [
             {
               "required": false,
@@ -21585,9 +21593,7 @@
               "name": "ant-man",
               "note": "The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. Please see the [blog post](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) for full details.\n\nTo access the API during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.ant-man-preview+json\n```"
             }
-          ],
-          "category": "repos",
-          "subcategory": "deployments"
+          ]
         },
         "x-octokit": {}
       }
@@ -23702,12 +23708,10 @@
               "application/json": {
                 "schema": {
                   "type": "array",
-                  "items": { "$ref": "#/components/schemas/issue-simple" }
+                  "items": { "$ref": "#/components/schemas/issue" }
                 },
                 "examples": {
-                  "default": {
-                    "$ref": "#/components/examples/issue-simple-items"
-                  }
+                  "default": { "$ref": "#/components/examples/issue-items" }
                 }
               }
             },
@@ -23720,15 +23724,19 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "issues",
           "previews": [
+            {
+              "required": false,
+              "name": "machine-man",
+              "note": "If an issue event is created via a GitHub App, the response will include the `performed_via_github_app` object with\tinformation about the GitHub App. For more information, see the [related blog\tpost](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access).\nTo receive the `performed_via_github_app` object in the response, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.machine-man-preview\n```"
+            },
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "issues",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       },
@@ -23898,15 +23906,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "issues",
+          "subcategory": "comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "issues",
-          "subcategory": "comments"
+          ]
         },
         "x-octokit": {}
       }
@@ -23943,15 +23951,20 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "issues",
+          "subcategory": "comments",
           "previews": [
+            {
+              "required": false,
+              "name": "machine-man",
+              "note": "If an issue event is created via a GitHub App, the response will include the `performed_via_github_app` object with\tinformation about the GitHub App. For more information, see the [related blog\tpost](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access).\nTo receive the `performed_via_github_app` object in the response, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.machine-man-preview\n```"
+            },
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "issues",
-          "subcategory": "comments"
+          ]
         },
         "x-octokit": {}
       },
@@ -24087,21 +24100,19 @@
             },
             "headers": { "Link": { "$ref": "#/components/headers/link" } }
           },
-          "404": { "$ref": "#/components/responses/not_found" },
-          "415": { "$ref": "#/components/responses/preview_header_missing" }
+          "404": { "$ref": "#/components/responses/not_found" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       },
@@ -24170,21 +24181,19 @@
               }
             }
           },
-          "415": { "$ref": "#/components/responses/preview_header_missing" },
           "422": { "$ref": "#/components/responses/validation_failed" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -24209,15 +24218,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -24361,15 +24369,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "issues",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "issues",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       },
@@ -24528,9 +24535,9 @@
             "description": "Response",
             "content": {
               "application/json": {
-                "schema": { "$ref": "#/components/schemas/issue-simple" },
+                "schema": { "$ref": "#/components/schemas/issue" },
                 "examples": {
-                  "default": { "$ref": "#/components/examples/issue-simple" }
+                  "default": { "$ref": "#/components/examples/issue" }
                 }
               }
             }
@@ -24581,9 +24588,9 @@
             "description": "Response",
             "content": {
               "application/json": {
-                "schema": { "$ref": "#/components/schemas/issue-simple" },
+                "schema": { "$ref": "#/components/schemas/issue" },
                 "examples": {
-                  "default": { "$ref": "#/components/examples/issue-simple" }
+                  "default": { "$ref": "#/components/examples/issue" }
                 }
               }
             }
@@ -24641,15 +24648,15 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "issues",
+          "subcategory": "comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "issues",
-          "subcategory": "comments"
+          ]
         },
         "x-octokit": {}
       },
@@ -25179,21 +25186,19 @@
             "headers": { "Link": { "$ref": "#/components/headers/link" } }
           },
           "404": { "$ref": "#/components/responses/not_found" },
-          "410": { "$ref": "#/components/responses/gone" },
-          "415": { "$ref": "#/components/responses/preview_header_missing" }
+          "410": { "$ref": "#/components/responses/gone" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       },
@@ -25262,21 +25267,19 @@
               }
             }
           },
-          "415": { "$ref": "#/components/responses/preview_header_missing" },
           "422": { "$ref": "#/components/responses/validation_failed" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": false,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -25301,15 +25304,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -27389,11 +27391,6 @@
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
           "previews": [
-            {
-              "required": false,
-              "name": "comfort-fade",
-              "note": "Multi-line comments in a pull request diff is currently available for developers to preview. During the preview period, these response fields may change without advance notice. See the [blog post](https://developer.github.com/changes/2019-10-03-multi-line-comments) for more information.\n\nTo create multi-line comments or see multi-line comments with the new supported fields during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.comfort-fade-preview+json\n```\n\nTo show multi-line comment-supported fields in the response, use the `comfort-fade` preview header and the `line` parameter.\n\nIf you use the `comfort-fade` preview header, your response will show:\n\n*   For multi-line comments, values for `start_line`, `original_start_line`, `start_side`, `line`, `original_line`, and `side`.\n*   For single-line comments, values for `line`, `original_line`, and `side` and a `null` value for `start_line`, `original_start_line`, and `start_side`.\n\nIf you don't use the `comfort-fade` preview header, multi-line and single-line comments will appear the same way in the response with a single `position` attribute. Your response will show:\n\n*   For multi-line comments, the last line of the comment range for the `position` attribute.\n*   For single-line comments, the diff-positioned way of referencing comments for the `position` attribute."
-            },
             {
               "required": false,
               "name": "squirrel-girl",
@@ -27443,11 +27440,6 @@
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
           "previews": [
-            {
-              "required": false,
-              "name": "comfort-fade",
-              "note": "Multi-line comments in a pull request diff is currently available for developers to preview. During the preview period, these response fields may change without advance notice. See the [blog post](https://developer.github.com/changes/2019-10-03-multi-line-comments) for more information.\n\nTo create multi-line comments or see multi-line comments with the new supported fields during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.comfort-fade-preview+json\n```\n\nTo show multi-line comment-supported fields in the response, use the `comfort-fade` preview header and the `line` parameter.\n\nIf you use the `comfort-fade` preview header, your response will show:\n\n*   For multi-line comments, values for `start_line`, `original_start_line`, `start_side`, `line`, `original_line`, and `side`.\n*   For single-line comments, values for `line`, `original_line`, and `side` and a `null` value for `start_line`, `original_start_line`, and `start_side`.\n\nIf you don't use the `comfort-fade` preview header, multi-line and single-line comments will appear the same way in the response with a single `position` attribute. Your response will show:\n\n*   For multi-line comments, the last line of the comment range for the `position` attribute.\n*   For single-line comments, the diff-positioned way of referencing comments for the `position` attribute."
-            },
             {
               "required": false,
               "name": "squirrel-girl",
@@ -27603,21 +27595,19 @@
             },
             "headers": { "Link": { "$ref": "#/components/headers/link" } }
           },
-          "404": { "$ref": "#/components/responses/not_found" },
-          "415": { "$ref": "#/components/responses/preview_header_missing" }
+          "404": { "$ref": "#/components/responses/not_found" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       },
@@ -27686,21 +27676,19 @@
               }
             }
           },
-          "415": { "$ref": "#/components/responses/preview_header_missing" },
           "422": { "$ref": "#/components/responses/validation_failed" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -27725,15 +27713,14 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -27906,11 +27893,6 @@
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
           "previews": [
-            {
-              "required": false,
-              "name": "comfort-fade",
-              "note": "Multi-line comments in a pull request diff is currently available for developers to preview. During the preview period, these response fields may change without advance notice. See the [blog post](https://developer.github.com/changes/2019-10-03-multi-line-comments) for more information.\n\nTo create multi-line comments or see multi-line comments with the new supported fields during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.comfort-fade-preview+json\n```\n\nTo show multi-line comment-supported fields in the response, use the `comfort-fade` preview header and the `line` parameter.\n\nIf you use the `comfort-fade` preview header, your response will show:\n\n*   For multi-line comments, values for `start_line`, `original_start_line`, `start_side`, `line`, `original_line`, and `side`.\n*   For single-line comments, values for `line`, `original_line`, and `side` and a `null` value for `start_line`, `original_start_line`, and `start_side`.\n\nIf you don't use the `comfort-fade` preview header, multi-line and single-line comments will appear the same way in the response with a single `position` attribute. Your response will show:\n\n*   For multi-line comments, the last line of the comment range for the `position` attribute.\n*   For single-line comments, the diff-positioned way of referencing comments for the `position` attribute."
-            },
             {
               "required": false,
               "name": "squirrel-girl",
@@ -29320,9 +29302,7 @@
           "category": "repos",
           "subcategory": "releases"
         },
-        "x-octokit": {
-          "diff": { "api.github.com.json": { "type": "changed" } }
-        }
+        "x-octokit": {}
       }
     },
     "/repos/{owner}/{repo}/releases/assets/{asset_id}": {
@@ -29651,9 +29631,7 @@
           "category": "repos",
           "subcategory": "releases"
         },
-        "x-octokit": {
-          "diff": { "api.github.com.json": { "type": "changed" } }
-        }
+        "x-octokit": {}
       },
       "delete": {
         "summary": "Delete a release",
@@ -29846,21 +29824,19 @@
               }
             }
           },
-          "415": { "$ref": "#/components/responses/preview_header_missing" },
           "422": { "$ref": "#/components/responses/validation_failed" }
         },
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -31176,6 +31152,7 @@
           { "$ref": "#/components/parameters/secret-name" }
         ],
         "requestBody": {
+          "required": true,
           "content": {
             "application/json": {
               "schema": {
@@ -31190,7 +31167,8 @@
                     "type": "string",
                     "description": "ID of the key you used to encrypt the secret."
                   }
-                }
+                },
+                "required": ["encrypted_value", "key_id"]
               },
               "example": {
                 "encrypted_value": "c2VjcmV0",
@@ -32418,17 +32396,17 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-01",
+          "deprecationDate": "2020-01-21",
+          "category": "teams",
+          "subcategory": "discussions",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-01",
-          "deprecationDate": "2020-01-21",
-          "category": "teams",
-          "subcategory": "discussions"
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -32490,17 +32468,17 @@
           "triggersNotification": true,
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-01",
+          "deprecationDate": "2020-01-21",
+          "category": "teams",
+          "subcategory": "discussions",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-01",
-          "deprecationDate": "2020-01-21",
-          "category": "teams",
-          "subcategory": "discussions"
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -32536,17 +32514,17 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-01",
+          "deprecationDate": "2020-01-21",
+          "category": "teams",
+          "subcategory": "discussions",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-01",
-          "deprecationDate": "2020-01-21",
-          "category": "teams",
-          "subcategory": "discussions"
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -32602,17 +32580,17 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-01",
+          "deprecationDate": "2020-01-21",
+          "category": "teams",
+          "subcategory": "discussions",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-01",
-          "deprecationDate": "2020-01-21",
-          "category": "teams",
-          "subcategory": "discussions"
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -32685,17 +32663,17 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-01",
+          "deprecationDate": "2020-01-21",
+          "category": "teams",
+          "subcategory": "discussion-comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-01",
-          "deprecationDate": "2020-01-21",
-          "category": "teams",
-          "subcategory": "discussion-comments"
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -32752,17 +32730,17 @@
           "triggersNotification": true,
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-01",
+          "deprecationDate": "2020-01-21",
+          "category": "teams",
+          "subcategory": "discussion-comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-01",
-          "deprecationDate": "2020-01-21",
-          "category": "teams",
-          "subcategory": "discussion-comments"
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -32803,17 +32781,17 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-01",
+          "deprecationDate": "2020-01-21",
+          "category": "teams",
+          "subcategory": "discussion-comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-01",
-          "deprecationDate": "2020-01-21",
-          "category": "teams",
-          "subcategory": "discussion-comments"
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -32870,17 +32848,17 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-01",
+          "deprecationDate": "2020-01-21",
+          "category": "teams",
+          "subcategory": "discussion-comments",
           "previews": [
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-01",
-          "deprecationDate": "2020-01-21",
-          "category": "teams",
-          "subcategory": "discussion-comments"
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -32969,17 +32947,16 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-21",
+          "deprecationDate": "2020-02-26",
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-21",
-          "deprecationDate": "2020-02-26",
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -33042,17 +33019,16 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-21",
+          "deprecationDate": "2020-02-26",
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-21",
-          "deprecationDate": "2020-02-26",
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -33113,17 +33089,16 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
+          "removalDate": "2021-02-21",
+          "deprecationDate": "2020-02-26",
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-21",
-          "deprecationDate": "2020-02-26",
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -33185,17 +33160,16 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": false,
+          "removalDate": "2021-02-21",
+          "deprecationDate": "2020-02-26",
+          "category": "reactions",
           "previews": [
             {
               "required": true,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "removalDate": "2021-02-21",
-          "deprecationDate": "2020-02-26",
-          "category": "reactions",
-          "subcategory": null
+          ]
         },
         "deprecated": true,
         "x-octokit": {}
@@ -34820,15 +34794,19 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": false,
+          "category": "issues",
           "previews": [
+            {
+              "required": false,
+              "name": "machine-man",
+              "note": "If an issue event is created via a GitHub App, the response will include the `performed_via_github_app` object with\tinformation about the GitHub App. For more information, see the [related blog\tpost](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access).\nTo receive the `performed_via_github_app` object in the response, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.machine-man-preview\n```"
+            },
             {
               "required": false,
               "name": "squirrel-girl",
               "note": "An additional `reactions` object in the issue comment payload is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details.\n\nTo access the API you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.squirrel-girl-preview\n```\nThe `reactions` key will have the following payload where `url` can be used to construct the API location for [listing and creating](https://docs.github.com/enterprise-server@3.2/rest/reference/reactions) reactions."
             }
-          ],
-          "category": "issues",
-          "subcategory": null
+          ]
         },
         "x-octokit": {}
       }
@@ -37107,6 +37085,54 @@
         "x-octokit": {}
       }
     },
+    "/repos/{owner}/{repo}/community/code_of_conduct": {
+      "get": {
+        "summary": "Get the code of conduct for a repository",
+        "description": "Returns the contents of the repository's code of conduct file, if one is detected.\n\nA code of conduct is detected if there is a file named `CODE_OF_CONDUCT` in the root directory of the repository. GitHub detects which code of conduct it is using fuzzy matching.",
+        "tags": ["codes-of-conduct"],
+        "operationId": "codes-of-conduct/get-for-repo",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/codes-of-conduct#get-the-code-of-conduct-for-a-repository"
+        },
+        "parameters": [
+          { "$ref": "#/components/parameters/owner" },
+          { "$ref": "#/components/parameters/repo" }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/code-of-conduct" },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/code-of-conduct-2"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "previews": [
+            {
+              "required": true,
+              "name": "scarlet-witch",
+              "note": "The Codes of Conduct API is currently available for developers to preview.\n\nTo access the API during the preview period, you must provide a custom [media type](https://docs.github.com/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.scarlet-witch-preview+json\n```"
+            }
+          ],
+          "category": "codes-of-conduct",
+          "subcategory": null,
+          "removalDate": "2021-09-29",
+          "deprecationDate": "2021-09-29"
+        },
+        "deprecated": true,
+        "x-octokit": {}
+      }
+    },
     "/enterprises/{enterprise}/audit-log": {
       "get": {
         "summary": "Get the audit log for an enterprise",
@@ -37879,20 +37905,6 @@
         "responses": { "501": { "description": "Not Implemented" } }
       }
     },
-    "/repos/{owner}/{repo}/community/code_of_conduct": {
-      "get": {
-        "summary": "Get the code of conduct for a repository",
-        "description": "This endpoint does not exist ghes-3.2.json. It was added in api.github.com.json",
-        "tags": ["codes-of-conduct"],
-        "operationId": "codes-of-conduct/get-for-repo",
-        "externalDocs": {
-          "description": "API method documentation",
-          "url": "https://docs.github.com/rest/reference/codes-of-conduct#get-the-code-of-conduct-for-a-repository"
-        },
-        "x-octokit": { "api.github.com.json": "removed" },
-        "responses": { "501": { "description": "Not Implemented" } }
-      }
-    },
     "/repos/{owner}/{repo}/community/profile": {
       "get": {
         "summary": "Get community profile metrics",
@@ -42100,49 +42112,6 @@
         },
         "required": ["id", "login", "gravatar_id", "url", "avatar_url"]
       },
-      "label": {
-        "title": "Label",
-        "description": "Color-coded labels help you categorize and filter your issues (just like labels in Gmail).",
-        "type": "object",
-        "properties": {
-          "id": { "type": "integer", "format": "int64", "example": 208045946 },
-          "node_id": {
-            "type": "string",
-            "example": "MDU6TGFiZWwyMDgwNDU5NDY="
-          },
-          "url": {
-            "description": "URL for the label",
-            "example": "https://api.github.com/repositories/42/labels/bug",
-            "type": "string",
-            "format": "uri"
-          },
-          "name": {
-            "description": "The name of the label.",
-            "example": "bug",
-            "type": "string"
-          },
-          "description": {
-            "type": "string",
-            "example": "Something isn't working",
-            "nullable": true
-          },
-          "color": {
-            "description": "6-character hex code, without the leading #, identifying the color",
-            "example": "FFFFFF",
-            "type": "string"
-          },
-          "default": { "type": "boolean", "example": true }
-        },
-        "required": [
-          "id",
-          "node_id",
-          "url",
-          "name",
-          "description",
-          "color",
-          "default"
-        ]
-      },
       "nullable-milestone": {
         "title": "Milestone",
         "description": "A collection of related issues and pull requests.",
@@ -42236,22 +42205,6 @@
         ],
         "nullable": true
       },
-      "author_association": {
-        "title": "author_association",
-        "type": "string",
-        "example": "OWNER",
-        "description": "How the author is associated with the repository.",
-        "enum": [
-          "COLLABORATOR",
-          "CONTRIBUTOR",
-          "FIRST_TIMER",
-          "FIRST_TIME_CONTRIBUTOR",
-          "MANNEQUIN",
-          "MEMBER",
-          "NONE",
-          "OWNER"
-        ]
-      },
       "nullable-integration": {
         "title": "GitHub app",
         "description": "GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.",
@@ -42359,53 +42312,111 @@
         ],
         "nullable": true
       },
-      "issue-simple": {
-        "title": "Issue Simple",
-        "description": "Issue Simple",
+      "author_association": {
+        "title": "author_association",
+        "type": "string",
+        "example": "OWNER",
+        "description": "How the author is associated with the repository.",
+        "enum": [
+          "COLLABORATOR",
+          "CONTRIBUTOR",
+          "FIRST_TIMER",
+          "FIRST_TIME_CONTRIBUTOR",
+          "MANNEQUIN",
+          "MEMBER",
+          "NONE",
+          "OWNER"
+        ]
+      },
+      "reaction-rollup": {
+        "title": "Reaction Rollup",
         "type": "object",
         "properties": {
-          "id": { "type": "integer", "example": 1 },
-          "node_id": { "type": "string", "example": "MDU6SXNzdWUx" },
+          "url": { "type": "string", "format": "uri" },
+          "total_count": { "type": "integer" },
+          "+1": { "type": "integer" },
+          "-1": { "type": "integer" },
+          "laugh": { "type": "integer" },
+          "confused": { "type": "integer" },
+          "heart": { "type": "integer" },
+          "hooray": { "type": "integer" },
+          "eyes": { "type": "integer" },
+          "rocket": { "type": "integer" }
+        },
+        "required": [
+          "url",
+          "total_count",
+          "+1",
+          "-1",
+          "laugh",
+          "confused",
+          "heart",
+          "hooray",
+          "eyes",
+          "rocket"
+        ]
+      },
+      "issue": {
+        "title": "Issue",
+        "description": "Issues are a great way to keep track of tasks, enhancements, and bugs for your projects.",
+        "type": "object",
+        "properties": {
+          "id": { "type": "integer" },
+          "node_id": { "type": "string" },
           "url": {
+            "description": "URL for the issue",
+            "example": "https://api.github.com/repositories/42/issues/1",
             "type": "string",
-            "format": "uri",
-            "example": "https://api.github.com/repos/octocat/Hello-World/issues/1347"
-          },
-          "repository_url": {
-            "type": "string",
-            "format": "uri",
-            "example": "https://api.github.com/repos/octocat/Hello-World"
-          },
-          "labels_url": {
-            "type": "string",
-            "example": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}"
+            "format": "uri"
           },
-          "comments_url": {
-            "type": "string",
-            "format": "uri",
-            "example": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments"
+          "repository_url": { "type": "string", "format": "uri" },
+          "labels_url": { "type": "string" },
+          "comments_url": { "type": "string", "format": "uri" },
+          "events_url": { "type": "string", "format": "uri" },
+          "html_url": { "type": "string", "format": "uri" },
+          "number": {
+            "description": "Number uniquely identifying the issue within its repository",
+            "example": 42,
+            "type": "integer"
           },
-          "events_url": {
-            "type": "string",
-            "format": "uri",
-            "example": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events"
+          "state": {
+            "description": "State of the issue; either 'open' or 'closed'",
+            "example": "open",
+            "type": "string"
           },
-          "html_url": {
-            "type": "string",
-            "format": "uri",
-            "example": "https://github.com/octocat/Hello-World/issues/1347"
+          "title": {
+            "description": "Title of the issue",
+            "example": "Widget creation fails in Safari on OS X 10.8",
+            "type": "string"
           },
-          "number": { "type": "integer", "example": 1347 },
-          "state": { "type": "string", "example": "open" },
-          "title": { "type": "string", "example": "Found a bug" },
           "body": {
+            "description": "Contents of the issue",
+            "example": "It looks like the new widget form is broken on Safari. When I try and create the widget, Safari crashes. This is reproducible on 10.8, but not 10.9. Maybe a browser bug?",
             "type": "string",
-            "example": "I'm having a problem with this."
+            "nullable": true
           },
           "user": { "$ref": "#/components/schemas/nullable-simple-user" },
           "labels": {
+            "description": "Labels to associate with this issue; pass one or more label names to replace the set of labels on this issue; send an empty array to clear all labels from the issue; note that the labels are silently dropped for users without push access to the repository",
+            "example": ["bug", "registration"],
             "type": "array",
-            "items": { "$ref": "#/components/schemas/label" }
+            "items": {
+              "oneOf": [
+                { "type": "string" },
+                {
+                  "type": "object",
+                  "properties": {
+                    "id": { "type": "integer", "format": "int64" },
+                    "node_id": { "type": "string" },
+                    "url": { "type": "string", "format": "uri" },
+                    "name": { "type": "string" },
+                    "description": { "type": "string", "nullable": true },
+                    "color": { "type": "string", "nullable": true },
+                    "default": { "type": "boolean" }
+                  }
+                }
+              ]
+            }
           },
           "assignee": { "$ref": "#/components/schemas/nullable-simple-user" },
           "assignees": {
@@ -42414,13 +42425,9 @@
             "nullable": true
           },
           "milestone": { "$ref": "#/components/schemas/nullable-milestone" },
-          "locked": { "type": "boolean", "example": true },
-          "active_lock_reason": {
-            "type": "string",
-            "example": "too heated",
-            "nullable": true
-          },
-          "comments": { "type": "integer", "example": 0 },
+          "locked": { "type": "boolean" },
+          "active_lock_reason": { "type": "string", "nullable": true },
+          "comments": { "type": "integer" },
           "pull_request": {
             "type": "object",
             "properties": {
@@ -42453,26 +42460,20 @@
             "format": "date-time",
             "nullable": true
           },
-          "created_at": {
-            "type": "string",
-            "format": "date-time",
-            "example": "2011-04-22T13:33:48Z"
-          },
-          "updated_at": {
-            "type": "string",
-            "format": "date-time",
-            "example": "2011-04-22T13:33:48Z"
-          },
-          "author_association": {
-            "$ref": "#/components/schemas/author_association"
-          },
+          "created_at": { "type": "string", "format": "date-time" },
+          "updated_at": { "type": "string", "format": "date-time" },
+          "closed_by": { "$ref": "#/components/schemas/nullable-simple-user" },
           "body_html": { "type": "string" },
           "body_text": { "type": "string" },
           "timeline_url": { "type": "string", "format": "uri" },
           "repository": { "$ref": "#/components/schemas/repository" },
           "performed_via_github_app": {
             "$ref": "#/components/schemas/nullable-integration"
-          }
+          },
+          "author_association": {
+            "$ref": "#/components/schemas/author_association"
+          },
+          "reactions": { "$ref": "#/components/schemas/reaction-rollup" }
         },
         "required": [
           "assignee",
@@ -42498,34 +42499,6 @@
           "updated_at"
         ]
       },
-      "reaction-rollup": {
-        "title": "Reaction Rollup",
-        "type": "object",
-        "properties": {
-          "url": { "type": "string", "format": "uri" },
-          "total_count": { "type": "integer" },
-          "+1": { "type": "integer" },
-          "-1": { "type": "integer" },
-          "laugh": { "type": "integer" },
-          "confused": { "type": "integer" },
-          "heart": { "type": "integer" },
-          "hooray": { "type": "integer" },
-          "eyes": { "type": "integer" },
-          "rocket": { "type": "integer" }
-        },
-        "required": [
-          "url",
-          "total_count",
-          "+1",
-          "-1",
-          "laugh",
-          "confused",
-          "heart",
-          "hooray",
-          "eyes",
-          "rocket"
-        ]
-      },
       "issue-comment": {
         "title": "Issue Comment",
         "description": "Comments provide a way for people to collaborate on an issue.",
@@ -42605,7 +42578,7 @@
             "type": "object",
             "properties": {
               "action": { "type": "string" },
-              "issue": { "$ref": "#/components/schemas/issue-simple" },
+              "issue": { "$ref": "#/components/schemas/issue" },
               "comment": { "$ref": "#/components/schemas/issue-comment" },
               "pages": {
                 "type": "array",
@@ -43097,149 +43070,6 @@
         },
         "required": ["name", "source"]
       },
-      "issue": {
-        "title": "Issue",
-        "description": "Issues are a great way to keep track of tasks, enhancements, and bugs for your projects.",
-        "type": "object",
-        "properties": {
-          "id": { "type": "integer" },
-          "node_id": { "type": "string" },
-          "url": {
-            "description": "URL for the issue",
-            "example": "https://api.github.com/repositories/42/issues/1",
-            "type": "string",
-            "format": "uri"
-          },
-          "repository_url": { "type": "string", "format": "uri" },
-          "labels_url": { "type": "string" },
-          "comments_url": { "type": "string", "format": "uri" },
-          "events_url": { "type": "string", "format": "uri" },
-          "html_url": { "type": "string", "format": "uri" },
-          "number": {
-            "description": "Number uniquely identifying the issue within its repository",
-            "example": 42,
-            "type": "integer"
-          },
-          "state": {
-            "description": "State of the issue; either 'open' or 'closed'",
-            "example": "open",
-            "type": "string"
-          },
-          "title": {
-            "description": "Title of the issue",
-            "example": "Widget creation fails in Safari on OS X 10.8",
-            "type": "string"
-          },
-          "body": {
-            "description": "Contents of the issue",
-            "example": "It looks like the new widget form is broken on Safari. When I try and create the widget, Safari crashes. This is reproducible on 10.8, but not 10.9. Maybe a browser bug?",
-            "type": "string",
-            "nullable": true
-          },
-          "user": { "$ref": "#/components/schemas/nullable-simple-user" },
-          "labels": {
-            "description": "Labels to associate with this issue; pass one or more label names to replace the set of labels on this issue; send an empty array to clear all labels from the issue; note that the labels are silently dropped for users without push access to the repository",
-            "example": ["bug", "registration"],
-            "type": "array",
-            "items": {
-              "oneOf": [
-                { "type": "string" },
-                {
-                  "type": "object",
-                  "properties": {
-                    "id": { "type": "integer", "format": "int64" },
-                    "node_id": { "type": "string" },
-                    "url": { "type": "string", "format": "uri" },
-                    "name": { "type": "string" },
-                    "description": { "type": "string", "nullable": true },
-                    "color": { "type": "string", "nullable": true },
-                    "default": { "type": "boolean" }
-                  }
-                }
-              ]
-            }
-          },
-          "assignee": { "$ref": "#/components/schemas/nullable-simple-user" },
-          "assignees": {
-            "type": "array",
-            "items": { "$ref": "#/components/schemas/simple-user" },
-            "nullable": true
-          },
-          "milestone": { "$ref": "#/components/schemas/nullable-milestone" },
-          "locked": { "type": "boolean" },
-          "active_lock_reason": { "type": "string", "nullable": true },
-          "comments": { "type": "integer" },
-          "pull_request": {
-            "type": "object",
-            "properties": {
-              "merged_at": {
-                "type": "string",
-                "format": "date-time",
-                "nullable": true
-              },
-              "diff_url": {
-                "type": "string",
-                "format": "uri",
-                "nullable": true
-              },
-              "html_url": {
-                "type": "string",
-                "format": "uri",
-                "nullable": true
-              },
-              "patch_url": {
-                "type": "string",
-                "format": "uri",
-                "nullable": true
-              },
-              "url": { "type": "string", "format": "uri", "nullable": true }
-            },
-            "required": ["diff_url", "html_url", "patch_url", "url"]
-          },
-          "closed_at": {
-            "type": "string",
-            "format": "date-time",
-            "nullable": true
-          },
-          "created_at": { "type": "string", "format": "date-time" },
-          "updated_at": { "type": "string", "format": "date-time" },
-          "closed_by": { "$ref": "#/components/schemas/nullable-simple-user" },
-          "body_html": { "type": "string" },
-          "body_text": { "type": "string" },
-          "timeline_url": { "type": "string", "format": "uri" },
-          "repository": { "$ref": "#/components/schemas/repository" },
-          "performed_via_github_app": {
-            "$ref": "#/components/schemas/nullable-integration"
-          },
-          "author_association": {
-            "$ref": "#/components/schemas/author_association"
-          },
-          "reactions": { "$ref": "#/components/schemas/reaction-rollup" }
-        },
-        "required": [
-          "assignee",
-          "closed_at",
-          "comments",
-          "comments_url",
-          "events_url",
-          "html_url",
-          "id",
-          "node_id",
-          "labels",
-          "labels_url",
-          "milestone",
-          "number",
-          "repository_url",
-          "state",
-          "locked",
-          "title",
-          "url",
-          "user",
-          "author_association",
-          "created_at",
-          "updated_at"
-        ]
-      },
       "license-simple": {
         "title": "License Simple",
         "description": "License Simple",
@@ -45981,6 +45811,9 @@
               },
               "code_scanning_upload": {
                 "$ref": "#/components/schemas/rate-limit"
+              },
+              "actions_runner_registration": {
+                "$ref": "#/components/schemas/rate-limit"
               }
             },
             "required": ["core", "search"]
@@ -48280,6 +48113,10 @@
         "type": "string",
         "description": "Identifies the variable values associated with the environment in which the analysis that generated this alert instance was performed, such as the language that was analyzed."
       },
+      "code-scanning-analysis-category": {
+        "type": "string",
+        "description": "Identifies the configuration under which the analysis was executed. Used to distinguish between multiple analyses for the same tool and commit, but performed on different languages or different parts of the code."
+      },
       "code-scanning-alert-location": {
         "type": "object",
         "description": "Describe a region within a file for the alert.",
@@ -48307,6 +48144,9 @@
           "environment": {
             "$ref": "#/components/schemas/code-scanning-alert-environment"
           },
+          "category": {
+            "$ref": "#/components/schemas/code-scanning-analysis-category"
+          },
           "state": { "$ref": "#/components/schemas/code-scanning-alert-state" },
           "commit_sha": { "type": "string" },
           "message": {
@@ -48482,10 +48322,6 @@
         "type": "string",
         "description": "Identifies the variable values associated with the environment in which this analysis was performed."
       },
-      "code-scanning-analysis-category": {
-        "type": "string",
-        "description": "Identifies the configuration under which the analysis was executed. Used to distinguish between multiple analyses for the same tool and commit, but performed on different languages or different parts of the code."
-      },
       "code-scanning-analysis-created-at": {
         "type": "string",
         "description": "The time that the analysis was created in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.",
@@ -50431,7 +50267,7 @@
             "format": "date-time",
             "example": "2011-04-14T16:00:49Z"
           },
-          "issue": { "$ref": "#/components/schemas/issue-simple" },
+          "issue": { "$ref": "#/components/schemas/issue" },
           "label": { "$ref": "#/components/schemas/issue-event-label" },
           "assignee": { "$ref": "#/components/schemas/nullable-simple-user" },
           "assigner": { "$ref": "#/components/schemas/nullable-simple-user" },
@@ -51071,6 +50907,49 @@
           { "$ref": "#/components/schemas/converted-note-to-issue-issue-event" }
         ]
       },
+      "label": {
+        "title": "Label",
+        "description": "Color-coded labels help you categorize and filter your issues (just like labels in Gmail).",
+        "type": "object",
+        "properties": {
+          "id": { "type": "integer", "format": "int64", "example": 208045946 },
+          "node_id": {
+            "type": "string",
+            "example": "MDU6TGFiZWwyMDgwNDU5NDY="
+          },
+          "url": {
+            "description": "URL for the label",
+            "example": "https://api.github.com/repositories/42/labels/bug",
+            "type": "string",
+            "format": "uri"
+          },
+          "name": {
+            "description": "The name of the label.",
+            "example": "bug",
+            "type": "string"
+          },
+          "description": {
+            "type": "string",
+            "example": "Something isn't working",
+            "nullable": true
+          },
+          "color": {
+            "description": "6-character hex code, without the leading #, identifying the color",
+            "example": "FFFFFF",
+            "type": "string"
+          },
+          "default": { "type": "boolean", "example": true }
+        },
+        "required": [
+          "id",
+          "node_id",
+          "url",
+          "name",
+          "description",
+          "color",
+          "default"
+        ]
+      },
       "timeline-comment-event": {
         "title": "Timeline Comment Event",
         "description": "Timeline Comment Event",
@@ -51145,7 +51024,7 @@
             "type": "object",
             "properties": {
               "type": { "type": "string" },
-              "issue": { "$ref": "#/components/schemas/issue-simple" }
+              "issue": { "$ref": "#/components/schemas/issue" }
             }
           }
         },
@@ -53655,7 +53534,8 @@
           "timeline_url": { "type": "string", "format": "uri" },
           "performed_via_github_app": {
             "$ref": "#/components/schemas/nullable-integration"
-          }
+          },
+          "reactions": { "$ref": "#/components/schemas/reaction-rollup" }
         },
         "required": [
           "assignee",
@@ -62937,6 +62817,7 @@
             "ref": "refs/pull/3740/merge",
             "analysis_key": ".github/workflows/codeql-analysis.yml:CodeQL-Build",
             "environment": "",
+            "category": ".github/workflows/codeql-analysis.yml:CodeQL-Build",
             "state": "fixed",
             "commit_sha": "b09da05606e27f463a2b49287684b4ae777092f2",
             "message": {
@@ -65786,7 +65667,7 @@
           "html_url": "https://github.com/octocat/Hello-World/invitations"
         }
       },
-      "issue-simple-items": {
+      "issue-items": {
         "value": [
           {
             "id": 1,
@@ -65923,6 +65804,26 @@
             "closed_at": null,
             "created_at": "2011-04-22T13:33:48Z",
             "updated_at": "2011-04-22T13:33:48Z",
+            "closed_by": {
+              "login": "octocat",
+              "id": 1,
+              "node_id": "MDQ6VXNlcjE=",
+              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+              "gravatar_id": "",
+              "url": "https://api.github.com/users/octocat",
+              "html_url": "https://github.com/octocat",
+              "followers_url": "https://api.github.com/users/octocat/followers",
+              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+              "organizations_url": "https://api.github.com/users/octocat/orgs",
+              "repos_url": "https://api.github.com/users/octocat/repos",
+              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+              "received_events_url": "https://api.github.com/users/octocat/received_events",
+              "type": "User",
+              "site_admin": false
+            },
             "author_association": "COLLABORATOR"
           }
         ]
@@ -66529,185 +66430,6 @@
           }
         }
       },
-      "issue-simple": {
-        "value": {
-          "id": 1,
-          "node_id": "MDU6SXNzdWUx",
-          "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
-          "repository_url": "https://api.github.com/repos/octocat/Hello-World",
-          "labels_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name}",
-          "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
-          "events_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/events",
-          "html_url": "https://github.com/octocat/Hello-World/issues/1347",
-          "number": 1347,
-          "state": "open",
-          "title": "Found a bug",
-          "body": "I'm having a problem with this.",
-          "user": {
-            "login": "octocat",
-            "id": 1,
-            "node_id": "MDQ6VXNlcjE=",
-            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
-            "gravatar_id": "",
-            "url": "https://api.github.com/users/octocat",
-            "html_url": "https://github.com/octocat",
-            "followers_url": "https://api.github.com/users/octocat/followers",
-            "following_url": "https://api.github.com/users/octocat/following{/other_user}",
-            "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
-            "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
-            "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
-            "organizations_url": "https://api.github.com/users/octocat/orgs",
-            "repos_url": "https://api.github.com/users/octocat/repos",
-            "events_url": "https://api.github.com/users/octocat/events{/privacy}",
-            "received_events_url": "https://api.github.com/users/octocat/received_events",
-            "type": "User",
-            "site_admin": false
-          },
-          "labels": [
-            {
-              "id": 208045946,
-              "node_id": "MDU6TGFiZWwyMDgwNDU5NDY=",
-              "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
-              "name": "bug",
-              "description": "Something isn't working",
-              "color": "f29513",
-              "default": true
-            }
-          ],
-          "assignee": {
-            "login": "octocat",
-            "id": 1,
-            "node_id": "MDQ6VXNlcjE=",
-            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
-            "gravatar_id": "",
-            "url": "https://api.github.com/users/octocat",
-            "html_url": "https://github.com/octocat",
-            "followers_url": "https://api.github.com/users/octocat/followers",
-            "following_url": "https://api.github.com/users/octocat/following{/other_user}",
-            "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
-            "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
-            "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
-            "organizations_url": "https://api.github.com/users/octocat/orgs",
-            "repos_url": "https://api.github.com/users/octocat/repos",
-            "events_url": "https://api.github.com/users/octocat/events{/privacy}",
-            "received_events_url": "https://api.github.com/users/octocat/received_events",
-            "type": "User",
-            "site_admin": false
-          },
-          "assignees": [
-            {
-              "login": "octocat",
-              "id": 1,
-              "node_id": "MDQ6VXNlcjE=",
-              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
-              "gravatar_id": "",
-              "url": "https://api.github.com/users/octocat",
-              "html_url": "https://github.com/octocat",
-              "followers_url": "https://api.github.com/users/octocat/followers",
-              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
-              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
-              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
-              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
-              "organizations_url": "https://api.github.com/users/octocat/orgs",
-              "repos_url": "https://api.github.com/users/octocat/repos",
-              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
-              "received_events_url": "https://api.github.com/users/octocat/received_events",
-              "type": "User",
-              "site_admin": false
-            },
-            {
-              "login": "hubot",
-              "id": 1,
-              "node_id": "MDQ6VXNlcjE=",
-              "avatar_url": "https://github.com/images/error/hubot_happy.gif",
-              "gravatar_id": "",
-              "url": "https://api.github.com/users/hubot",
-              "html_url": "https://github.com/hubot",
-              "followers_url": "https://api.github.com/users/hubot/followers",
-              "following_url": "https://api.github.com/users/hubot/following{/other_user}",
-              "gists_url": "https://api.github.com/users/hubot/gists{/gist_id}",
-              "starred_url": "https://api.github.com/users/hubot/starred{/owner}{/repo}",
-              "subscriptions_url": "https://api.github.com/users/hubot/subscriptions",
-              "organizations_url": "https://api.github.com/users/hubot/orgs",
-              "repos_url": "https://api.github.com/users/hubot/repos",
-              "events_url": "https://api.github.com/users/hubot/events{/privacy}",
-              "received_events_url": "https://api.github.com/users/hubot/received_events",
-              "type": "User",
-              "site_admin": true
-            },
-            {
-              "login": "other_user",
-              "id": 1,
-              "node_id": "MDQ6VXNlcjE=",
-              "avatar_url": "https://github.com/images/error/other_user_happy.gif",
-              "gravatar_id": "",
-              "url": "https://api.github.com/users/other_user",
-              "html_url": "https://github.com/other_user",
-              "followers_url": "https://api.github.com/users/other_user/followers",
-              "following_url": "https://api.github.com/users/other_user/following{/other_user}",
-              "gists_url": "https://api.github.com/users/other_user/gists{/gist_id}",
-              "starred_url": "https://api.github.com/users/other_user/starred{/owner}{/repo}",
-              "subscriptions_url": "https://api.github.com/users/other_user/subscriptions",
-              "organizations_url": "https://api.github.com/users/other_user/orgs",
-              "repos_url": "https://api.github.com/users/other_user/repos",
-              "events_url": "https://api.github.com/users/other_user/events{/privacy}",
-              "received_events_url": "https://api.github.com/users/other_user/received_events",
-              "type": "User",
-              "site_admin": false
-            }
-          ],
-          "milestone": {
-            "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
-            "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
-            "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
-            "id": 1002604,
-            "node_id": "MDk6TWlsZXN0b25lMTAwMjYwNA==",
-            "number": 1,
-            "state": "open",
-            "title": "v1.0",
-            "description": "Tracking milestone for version 1.0",
-            "creator": {
-              "login": "octocat",
-              "id": 1,
-              "node_id": "MDQ6VXNlcjE=",
-              "avatar_url": "https://github.com/images/error/octocat_happy.gif",
-              "gravatar_id": "",
-              "url": "https://api.github.com/users/octocat",
-              "html_url": "https://github.com/octocat",
-              "followers_url": "https://api.github.com/users/octocat/followers",
-              "following_url": "https://api.github.com/users/octocat/following{/other_user}",
-              "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
-              "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
-              "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
-              "organizations_url": "https://api.github.com/users/octocat/orgs",
-              "repos_url": "https://api.github.com/users/octocat/repos",
-              "events_url": "https://api.github.com/users/octocat/events{/privacy}",
-              "received_events_url": "https://api.github.com/users/octocat/received_events",
-              "type": "User",
-              "site_admin": false
-            },
-            "open_issues": 4,
-            "closed_issues": 8,
-            "created_at": "2011-04-10T20:09:31Z",
-            "updated_at": "2014-03-03T18:58:10Z",
-            "closed_at": "2013-02-12T13:22:01Z",
-            "due_on": "2012-10-09T23:39:01Z"
-          },
-          "locked": true,
-          "active_lock_reason": "too heated",
-          "comments": 0,
-          "pull_request": {
-            "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
-            "html_url": "https://github.com/octocat/Hello-World/pull/1347",
-            "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
-            "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch"
-          },
-          "closed_at": null,
-          "created_at": "2011-04-22T13:33:48Z",
-          "updated_at": "2011-04-22T13:33:48Z",
-          "author_association": "COLLABORATOR"
-        }
-      },
       "issue-event-for-issue-items": {
         "value": [
           {