@octokit/openapi 16.2.0 → 16.4.0

package/generated/ghes-3.12.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "16.2.0",
+    "version": "16.4.0",
     "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": {
@@ -3839,7 +3839,7 @@
     "/app/installations/{installation_id}/access_tokens": {
       "post": {
         "summary": "Create an installation access token for an app",
-        "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. \n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nWhen using the repository or permission parameters to reduce the access of the token, the complexity of the token is increased due to both the number of permissions in the request and the number of repositories the token will have access to. If the complexity is too large, the token will fail to be issued. If this occurs, the error message will indicate the maximum number of repositories that should be requested. For the average application requesting 8 permissions, this limit is around 5000 repositories. With fewer permissions requested, more repositories are supported. \n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.12/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.",
+        "description": "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access.\n\nOptionally, you can use the `repositories` or `repository_ids` body parameters to specify individual repositories that the installation access token can access. If you don't use `repositories` or `repository_ids` to grant access to specific repositories, the installation access token will have access to all repositories that the installation was granted access to. The installation access token cannot be granted access to repositories that the installation was not granted access to. Up to 500 repositories can be listed in this manner.\n\nOptionally, use the `permissions` body parameter to specify the permissions that the installation access token should have. If `permissions` is not specified, the installation access token will have all of the permissions that were granted to the app. The installation access token cannot be granted permissions that the app was not granted.\n\nWhen using the repository or permission parameters to reduce the access of the token, the complexity of the token is increased due to both the number of permissions in the request and the number of repositories the token will have access to. If the complexity is too large, the token will fail to be issued. If this occurs, the error message will indicate the maximum number of repositories that should be requested. For the average application requesting 8 permissions, this limit is around 5000 repositories. With fewer permissions requested, more repositories are supported.\n\nYou must use a [JWT](https://docs.github.com/enterprise-server@3.12/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint.",
         "tags": [
           "apps"
         ],
@@ -10794,6 +10794,360 @@
         "x-octokit": {}
       }
     },
+    "/manage/v1/config/apply": {
+      "get": {
+        "summary": "Get the status of a ghe-config-apply run",
+        "description": "Displays the current status of `ghe-config-apply` in the environment or the status of a historical run by ID.",
+        "operationId": "enterprise-admin/get-manage-settings",
+        "tags": [
+          "enterprise-admin"
+        ],
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.12/rest/enterprise-admin/manage-ghes#get-config-apply-status"
+        },
+        "parameters": [
+          {
+            "name": "run_id",
+            "description": "The unique run ID of the `ghe-config-apply` run.",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "servers": [
+          {
+            "url": "{protocol}://{hostname}",
+            "variables": {
+              "hostname": {
+                "default": "HOSTNAME",
+                "description": "Self-hosted Enterprise Server hostname"
+              },
+              "protocol": {
+                "default": "http",
+                "description": "Self-hosted Enterprise Server protocol"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "running": {
+                      "type": "boolean",
+                      "description": "Whether the ghe-config-apply run is still running in the environment"
+                    },
+                    "successful": {
+                      "type": "boolean",
+                      "description": "Whether the ghe-config-apply run was successful in the environment"
+                    },
+                    "nodes": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "run_id": {
+                            "type": "string",
+                            "description": "The unique Run ID of the ghe-config-apply run on the host"
+                          },
+                          "hostname": {
+                            "type": "string",
+                            "description": "The hostname of the node"
+                          },
+                          "running": {
+                            "type": "boolean",
+                            "description": "Whether the ghe-config-apply run is still running on the host"
+                          },
+                          "successful": {
+                            "type": "boolean",
+                            "description": "Whether the ghe-config-apply run was successful on the host"
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "running": true,
+                      "successful": false,
+                      "nodes": [
+                        {
+                          "run_id": "d34db33f",
+                          "hostname": "ghes-01.lan",
+                          "running": true,
+                          "successful": false
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": false,
+          "category": "enterprise-admin",
+          "subcategory": "manage-ghes"
+        },
+        "x-octokit": {}
+      },
+      "post": {
+        "summary": "Trigger a ghe-config-apply run",
+        "description": "Triggers a run of `ghe-config-apply` from the `ghes-manage` agent on your Nomad Delegate instance.\nYou can provide a run ID or allow one to be generated randomly.",
+        "operationId": "enterprise-admin/get-manage-settings",
+        "tags": [
+          "enterprise-admin"
+        ],
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.12/rest/enterprise-admin/manage-ghes#run-config-apply"
+        },
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "run_id": {
+                    "type": "string",
+                    "description": "The run ID to execute `ghe-config-apply` with. If not provided, a run ID will be generated randomly."
+                  }
+                }
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "run_id": "d34db33f"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "servers": [
+          {
+            "url": "{protocol}://{hostname}",
+            "variables": {
+              "hostname": {
+                "default": "HOSTNAME",
+                "description": "Self-hosted Enterprise Server hostname"
+              },
+              "protocol": {
+                "default": "http",
+                "description": "Self-hosted Enterprise Server protocol"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "run_id": {
+                      "type": "string",
+                      "description": "Run ID the job was launched with"
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "run_id": "d34db33f"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": false,
+          "category": "enterprise-admin",
+          "subcategory": "manage-ghes"
+        },
+        "x-octokit": {}
+      }
+    },
+    "/manage/v1/config/apply/events": {
+      "get": {
+        "summary": "List events from ghe-config-apply",
+        "description": "Lists events from an in-process `ghe-config-apply` run on your Github Enterprise Server instance.",
+        "operationId": "enterprise-admin/get-manage-settings",
+        "tags": [
+          "enterprise-admin"
+        ],
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.12/rest/enterprise-admin/manage-ghes#get-config-apply-events"
+        },
+        "parameters": [
+          {
+            "name": "last_request_id",
+            "description": "The unique ID of the last response from a host, used for pagination.",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "servers": [
+          {
+            "url": "{protocol}://{hostname}",
+            "variables": {
+              "hostname": {
+                "default": "HOSTNAME",
+                "description": "Self-hosted Enterprise Server hostname"
+              },
+              "protocol": {
+                "default": "http",
+                "description": "Self-hosted Enterprise Server protocol"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "nodes": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "node": {
+                            "type": "string",
+                            "description": "Hostname of the node"
+                          },
+                          "last_request_id": {
+                            "type": "string",
+                            "description": "Unique ID of the last response from a host used for pagination"
+                          },
+                          "events": {
+                            "type": "array",
+                            "items": {
+                              "type": "object",
+                              "properties": {
+                                "timestamp": {
+                                  "type": "string"
+                                },
+                                "severity_text": {
+                                  "type": "string"
+                                },
+                                "body": {
+                                  "type": "string"
+                                },
+                                "event_name": {
+                                  "type": "string"
+                                },
+                                "topology": {
+                                  "type": "string"
+                                },
+                                "hostname": {
+                                  "type": "string"
+                                },
+                                "config_run_id": {
+                                  "type": "string"
+                                },
+                                "trace_id": {
+                                  "type": "string"
+                                },
+                                "span_id": {
+                                  "type": "string"
+                                },
+                                "span_parent_id": {
+                                  "type": "string"
+                                },
+                                "span_depth": {
+                                  "type": "integer"
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "nodes": [
+                        {
+                          "node": "ghes-01.lan",
+                          "last_request_id": "387cd628c06d606700e79be368e5e574:0cde553750689c76:0000000000000000",
+                          "events": [
+                            {
+                              "timestamp": "2023-01-01T13:00:00+00:00",
+                              "severity_text": "INFO",
+                              "body": "Validating services",
+                              "event_name": "Enterprise::ConfigApply::PhaseValidation#config_phase_validation",
+                              "topology": "multinode",
+                              "hostname": "ghes-01.lan",
+                              "config_run_id": "d34db33f",
+                              "trace_id": "387cd628c06d606700e79be368e5e574",
+                              "span_id": "0cde553750689c76",
+                              "span_parent_id": 0,
+                              "span_depth": 0
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": false,
+          "category": "enterprise-admin",
+          "subcategory": "manage-ghes"
+        },
+        "x-octokit": {}
+      }
+    },
     "/manage/v1/config/init": {
       "post": {
         "summary": "Initialize instance configuration with license upload",
@@ -17300,7 +17654,7 @@
     "/orgs/{org}/hooks": {
       "get": {
         "summary": "List organization webhooks",
-        "description": "You must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "You must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17358,7 +17712,7 @@
       },
       "post": {
         "summary": "Create an organization webhook",
-        "description": "Create a hook that posts payloads in JSON format.\n\nYou must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or \nedit webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "Create a hook that posts payloads in JSON format.\n\nYou must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or\nedit webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17495,7 +17849,7 @@
     "/orgs/{org}/hooks/{hook_id}": {
       "get": {
         "summary": "Get an organization webhook",
-        "description": "Returns a webhook configured in an organization. To get only the webhook\n`config` properties, see \"[Get a webhook configuration for an organization](/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization). \n\nYou must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "Returns a webhook configured in an organization. To get only the webhook\n`config` properties, see \"[Get a webhook configuration for an organization](/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization).\n\nYou must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17542,7 +17896,7 @@
       },
       "patch": {
         "summary": "Update an organization webhook",
-        "description": "Updates a webhook configured in an organization. When you update a webhook,\nthe `secret` will be overwritten. If you previously had a `secret` set, you must\nprovide the same `secret` or set a new `secret` or the secret will be removed. If\nyou are only updating individual webhook `config` properties, use \"[Update a webhook\nconfiguration for an organization](/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization)\". \n\nYou must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "Updates a webhook configured in an organization. When you update a webhook,\nthe `secret` will be overwritten. If you previously had a `secret` set, you must\nprovide the same `secret` or set a new `secret` or the secret will be removed. If\nyou are only updating individual webhook `config` properties, use \"[Update a webhook\nconfiguration for an organization](/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization)\".\n\nYou must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17654,7 +18008,7 @@
       },
       "delete": {
         "summary": "Delete an organization webhook",
-        "description": "You must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "You must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17691,7 +18045,7 @@
     "/orgs/{org}/hooks/{hook_id}/config": {
       "get": {
         "summary": "Get a webhook configuration for an organization",
-        "description": "Returns the webhook configuration for an organization. To get more information about the webhook, including the `active` state and `events`, use \"[Get an organization webhook ](/rest/orgs/webhooks#get-an-organization-webhook).\"\n\nYou must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "Returns the webhook configuration for an organization. To get more information about the webhook, including the `active` state and `events`, use \"[Get an organization webhook ](/rest/orgs/webhooks#get-an-organization-webhook).\"\n\nYou must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17735,7 +18089,7 @@
       },
       "patch": {
         "summary": "Update a webhook configuration for an organization",
-        "description": "Updates the webhook configuration for an organization. To update more information about the webhook, including the `active` state and `events`, use \"[Update an organization webhook ](/rest/orgs/webhooks#update-an-organization-webhook).\"\n\nYou must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "Updates the webhook configuration for an organization. To update more information about the webhook, including the `active` state and `events`, use \"[Update an organization webhook ](/rest/orgs/webhooks#update-an-organization-webhook).\"\n\nYou must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17816,7 +18170,7 @@
     "/orgs/{org}/hooks/{hook_id}/deliveries": {
       "get": {
         "summary": "List deliveries for an organization webhook",
-        "description": "Returns a list of webhook deliveries for a webhook configured in an organization.\n\nYou must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "Returns a list of webhook deliveries for a webhook configured in an organization.\n\nYou must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17885,7 +18239,7 @@
     "/orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}": {
       "get": {
         "summary": "Get a webhook delivery for an organization webhook",
-        "description": "Returns a delivery for a webhook configured in an organization.\n\nYou must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "Returns a delivery for a webhook configured in an organization.\n\nYou must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17940,7 +18294,7 @@
     "/orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts": {
       "post": {
         "summary": "Redeliver a delivery for an organization webhook",
-        "description": "Redeliver a delivery for a webhook configured in an organization.\n\nYou must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "Redeliver a delivery for a webhook configured in an organization.\n\nYou must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -17983,7 +18337,7 @@
     "/orgs/{org}/hooks/{hook_id}/pings": {
       "post": {
         "summary": "Ping an organization webhook",
-        "description": "This will trigger a [ping event](https://docs.github.com/enterprise-server@3.12/webhooks/#ping-event)\nto be sent to the hook.\n\nYou must be an organization owner to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit \nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
+        "description": "This will trigger a [ping event](https://docs.github.com/enterprise-server@3.12/webhooks/#ping-event)\nto be sent to the hook.\n\nYou must be an organization owner to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit\nwebhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
         "tags": [
           "orgs"
         ],
@@ -92844,6 +93198,56 @@
           "swift"
         ]
       },
+      "vulnerability": {
+        "description": "A vulnerability describing the product and its affected versions within a GitHub Security Advisory.",
+        "type": "object",
+        "properties": {
+          "package": {
+            "description": "The name of the package affected by the vulnerability.",
+            "type": "object",
+            "nullable": true,
+            "properties": {
+              "ecosystem": {
+                "$ref": "#/components/schemas/security-advisory-ecosystems"
+              },
+              "name": {
+                "type": "string",
+                "description": "The unique package name within its ecosystem.",
+                "nullable": true
+              }
+            },
+            "required": [
+              "ecosystem",
+              "name"
+            ]
+          },
+          "vulnerable_version_range": {
+            "type": "string",
+            "description": "The range of the package versions affected by the vulnerability.",
+            "nullable": true
+          },
+          "first_patched_version": {
+            "type": "string",
+            "description": "The package version that resolves the vulnerability.",
+            "nullable": true
+          },
+          "vulnerable_functions": {
+            "type": "array",
+            "description": "The functions in the package that are affected by the vulnerability.",
+            "nullable": true,
+            "readOnly": true,
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "package",
+          "vulnerable_version_range",
+          "first_patched_version",
+          "vulnerable_functions"
+        ]
+      },
       "security-advisory-credit-types": {
         "type": "string",
         "description": "The type of credit the user is receiving.",
@@ -93003,53 +93407,7 @@
             "description": "The products and respective version ranges affected by the advisory.",
             "nullable": true,
             "items": {
-              "type": "object",
-              "properties": {
-                "package": {
-                  "description": "The name of the package affected by the vulnerability.",
-                  "type": "object",
-                  "nullable": true,
-                  "properties": {
-                    "ecosystem": {
-                      "$ref": "#/components/schemas/security-advisory-ecosystems"
-                    },
-                    "name": {
-                      "type": "string",
-                      "description": "The unique package name within its ecosystem.",
-                      "nullable": true
-                    }
-                  },
-                  "required": [
-                    "ecosystem",
-                    "name"
-                  ]
-                },
-                "vulnerable_version_range": {
-                  "type": "string",
-                  "description": "The range of the package versions affected by the vulnerability.",
-                  "nullable": true
-                },
-                "first_patched_version": {
-                  "type": "string",
-                  "description": "The package version that resolve the vulnerability.",
-                  "nullable": true
-                },
-                "vulnerable_functions": {
-                  "type": "array",
-                  "description": "The functions in the package that are affected by the vulnerability.",
-                  "nullable": true,
-                  "readOnly": true,
-                  "items": {
-                    "type": "string"
-                  }
-                }
-              },
-              "required": [
-                "package",
-                "vulnerable_version_range",
-                "first_patched_version",
-                "vulnerable_functions"
-              ]
+              "$ref": "#/components/schemas/vulnerability"
             }
           },
           "cvss": {
@@ -123283,6 +123641,171 @@
           "url"
         ]
       },
+      "webhooks_rule": {
+        "title": "branch protection rule",
+        "description": "The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/enterprise-server@3.12/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) applied to branches that match the name. Binary settings are boolean. Multi-level configurations are one of `off`, `non_admins`, or `everyone`. Actor and build lists are arrays of strings.",
+        "type": "object",
+        "properties": {
+          "admin_enforced": {
+            "type": "boolean"
+          },
+          "allow_deletions_enforcement_level": {
+            "type": "string",
+            "enum": [
+              "off",
+              "non_admins",
+              "everyone"
+            ]
+          },
+          "allow_force_pushes_enforcement_level": {
+            "type": "string",
+            "enum": [
+              "off",
+              "non_admins",
+              "everyone"
+            ]
+          },
+          "authorized_actor_names": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "authorized_actors_only": {
+            "type": "boolean"
+          },
+          "authorized_dismissal_actors_only": {
+            "type": "boolean"
+          },
+          "create_protected": {
+            "type": "boolean"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "dismiss_stale_reviews_on_push": {
+            "type": "boolean"
+          },
+          "id": {
+            "type": "integer"
+          },
+          "ignore_approvals_from_contributors": {
+            "type": "boolean"
+          },
+          "linear_history_requirement_enforcement_level": {
+            "type": "string",
+            "enum": [
+              "off",
+              "non_admins",
+              "everyone"
+            ]
+          },
+          "merge_queue_enforcement_level": {
+            "type": "string",
+            "enum": [
+              "off",
+              "non_admins",
+              "everyone"
+            ]
+          },
+          "name": {
+            "type": "string"
+          },
+          "pull_request_reviews_enforcement_level": {
+            "type": "string",
+            "enum": [
+              "off",
+              "non_admins",
+              "everyone"
+            ]
+          },
+          "repository_id": {
+            "type": "integer"
+          },
+          "require_code_owner_review": {
+            "type": "boolean"
+          },
+          "require_last_push_approval": {
+            "description": "Whether the most recent push must be approved by someone other than the person who pushed it",
+            "type": "boolean"
+          },
+          "required_approving_review_count": {
+            "type": "integer"
+          },
+          "required_conversation_resolution_level": {
+            "type": "string",
+            "enum": [
+              "off",
+              "non_admins",
+              "everyone"
+            ]
+          },
+          "required_deployments_enforcement_level": {
+            "type": "string",
+            "enum": [
+              "off",
+              "non_admins",
+              "everyone"
+            ]
+          },
+          "required_status_checks": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "required_status_checks_enforcement_level": {
+            "type": "string",
+            "enum": [
+              "off",
+              "non_admins",
+              "everyone"
+            ]
+          },
+          "signature_requirement_enforcement_level": {
+            "type": "string",
+            "enum": [
+              "off",
+              "non_admins",
+              "everyone"
+            ]
+          },
+          "strict_required_status_checks_policy": {
+            "type": "boolean"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "id",
+          "repository_id",
+          "name",
+          "created_at",
+          "updated_at",
+          "pull_request_reviews_enforcement_level",
+          "required_approving_review_count",
+          "dismiss_stale_reviews_on_push",
+          "require_code_owner_review",
+          "authorized_dismissal_actors_only",
+          "ignore_approvals_from_contributors",
+          "required_status_checks",
+          "required_status_checks_enforcement_level",
+          "strict_required_status_checks_policy",
+          "signature_requirement_enforcement_level",
+          "linear_history_requirement_enforcement_level",
+          "admin_enforced",
+          "allow_force_pushes_enforcement_level",
+          "allow_deletions_enforcement_level",
+          "merge_queue_enforcement_level",
+          "required_deployments_enforcement_level",
+          "required_conversation_resolution_level",
+          "authorized_actors_only",
+          "authorized_actor_names"
+        ]
+      },
       "simple-check-suite": {
         "description": "A suite of checks performed on the code of a given code change",
         "type": "object",
@@ -125378,169 +125901,7 @@
             "$ref": "#/components/schemas/repository-webhooks"
           },
           "rule": {
-            "title": "branch protection rule",
-            "description": "The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/enterprise-server@3.12/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) applied to branches that match the name. Binary settings are boolean. Multi-level configurations are one of `off`, `non_admins`, or `everyone`. Actor and build lists are arrays of strings.",
-            "type": "object",
-            "properties": {
-              "admin_enforced": {
-                "type": "boolean"
-              },
-              "allow_deletions_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "allow_force_pushes_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "authorized_actor_names": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "authorized_actors_only": {
-                "type": "boolean"
-              },
-              "authorized_dismissal_actors_only": {
-                "type": "boolean"
-              },
-              "create_protected": {
-                "type": "boolean"
-              },
-              "created_at": {
-                "type": "string",
-                "format": "date-time"
-              },
-              "dismiss_stale_reviews_on_push": {
-                "type": "boolean"
-              },
-              "id": {
-                "type": "integer"
-              },
-              "ignore_approvals_from_contributors": {
-                "type": "boolean"
-              },
-              "linear_history_requirement_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "merge_queue_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "name": {
-                "type": "string"
-              },
-              "pull_request_reviews_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "repository_id": {
-                "type": "integer"
-              },
-              "require_code_owner_review": {
-                "type": "boolean"
-              },
-              "require_last_push_approval": {
-                "description": "Whether the most recent push must be approved by someone other than the person who pushed it",
-                "type": "boolean"
-              },
-              "required_approving_review_count": {
-                "type": "integer"
-              },
-              "required_conversation_resolution_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "required_deployments_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "required_status_checks": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "required_status_checks_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "signature_requirement_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "strict_required_status_checks_policy": {
-                "type": "boolean"
-              },
-              "updated_at": {
-                "type": "string",
-                "format": "date-time"
-              }
-            },
-            "required": [
-              "id",
-              "repository_id",
-              "name",
-              "created_at",
-              "updated_at",
-              "pull_request_reviews_enforcement_level",
-              "required_approving_review_count",
-              "dismiss_stale_reviews_on_push",
-              "require_code_owner_review",
-              "authorized_dismissal_actors_only",
-              "ignore_approvals_from_contributors",
-              "required_status_checks",
-              "required_status_checks_enforcement_level",
-              "strict_required_status_checks_policy",
-              "signature_requirement_enforcement_level",
-              "linear_history_requirement_enforcement_level",
-              "admin_enforced",
-              "allow_force_pushes_enforcement_level",
-              "allow_deletions_enforcement_level",
-              "merge_queue_enforcement_level",
-              "required_deployments_enforcement_level",
-              "required_conversation_resolution_level",
-              "authorized_actors_only",
-              "authorized_actor_names"
-            ]
+            "$ref": "#/components/schemas/webhooks_rule"
           },
           "sender": {
             "$ref": "#/components/schemas/simple-user-webhooks"
@@ -125576,169 +125937,7 @@
             "$ref": "#/components/schemas/repository-webhooks"
           },
           "rule": {
-            "title": "branch protection rule",
-            "description": "The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/enterprise-server@3.12/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) applied to branches that match the name. Binary settings are boolean. Multi-level configurations are one of `off`, `non_admins`, or `everyone`. Actor and build lists are arrays of strings.",
-            "type": "object",
-            "properties": {
-              "admin_enforced": {
-                "type": "boolean"
-              },
-              "allow_deletions_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "allow_force_pushes_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "authorized_actor_names": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "authorized_actors_only": {
-                "type": "boolean"
-              },
-              "authorized_dismissal_actors_only": {
-                "type": "boolean"
-              },
-              "create_protected": {
-                "type": "boolean"
-              },
-              "created_at": {
-                "type": "string",
-                "format": "date-time"
-              },
-              "dismiss_stale_reviews_on_push": {
-                "type": "boolean"
-              },
-              "id": {
-                "type": "integer"
-              },
-              "ignore_approvals_from_contributors": {
-                "type": "boolean"
-              },
-              "linear_history_requirement_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "merge_queue_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "name": {
-                "type": "string"
-              },
-              "pull_request_reviews_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "repository_id": {
-                "type": "integer"
-              },
-              "require_code_owner_review": {
-                "type": "boolean"
-              },
-              "require_last_push_approval": {
-                "description": "Whether the most recent push must be approved by someone other than the person who pushed it",
-                "type": "boolean"
-              },
-              "required_approving_review_count": {
-                "type": "integer"
-              },
-              "required_conversation_resolution_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "required_deployments_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "required_status_checks": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "required_status_checks_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "signature_requirement_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "strict_required_status_checks_policy": {
-                "type": "boolean"
-              },
-              "updated_at": {
-                "type": "string",
-                "format": "date-time"
-              }
-            },
-            "required": [
-              "id",
-              "repository_id",
-              "name",
-              "created_at",
-              "updated_at",
-              "pull_request_reviews_enforcement_level",
-              "required_approving_review_count",
-              "dismiss_stale_reviews_on_push",
-              "require_code_owner_review",
-              "authorized_dismissal_actors_only",
-              "ignore_approvals_from_contributors",
-              "required_status_checks",
-              "required_status_checks_enforcement_level",
-              "strict_required_status_checks_policy",
-              "signature_requirement_enforcement_level",
-              "linear_history_requirement_enforcement_level",
-              "admin_enforced",
-              "allow_force_pushes_enforcement_level",
-              "allow_deletions_enforcement_level",
-              "merge_queue_enforcement_level",
-              "required_deployments_enforcement_level",
-              "required_conversation_resolution_level",
-              "authorized_actors_only",
-              "authorized_actor_names"
-            ]
+            "$ref": "#/components/schemas/webhooks_rule"
           },
           "sender": {
             "$ref": "#/components/schemas/simple-user-webhooks"
@@ -125876,169 +126075,7 @@
             "$ref": "#/components/schemas/repository-webhooks"
           },
           "rule": {
-            "title": "branch protection rule",
-            "description": "The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/enterprise-server@3.12/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) applied to branches that match the name. Binary settings are boolean. Multi-level configurations are one of `off`, `non_admins`, or `everyone`. Actor and build lists are arrays of strings.",
-            "type": "object",
-            "properties": {
-              "admin_enforced": {
-                "type": "boolean"
-              },
-              "allow_deletions_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "allow_force_pushes_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "authorized_actor_names": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "authorized_actors_only": {
-                "type": "boolean"
-              },
-              "authorized_dismissal_actors_only": {
-                "type": "boolean"
-              },
-              "create_protected": {
-                "type": "boolean"
-              },
-              "created_at": {
-                "type": "string",
-                "format": "date-time"
-              },
-              "dismiss_stale_reviews_on_push": {
-                "type": "boolean"
-              },
-              "id": {
-                "type": "integer"
-              },
-              "ignore_approvals_from_contributors": {
-                "type": "boolean"
-              },
-              "linear_history_requirement_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "merge_queue_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "name": {
-                "type": "string"
-              },
-              "pull_request_reviews_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "repository_id": {
-                "type": "integer"
-              },
-              "require_code_owner_review": {
-                "type": "boolean"
-              },
-              "require_last_push_approval": {
-                "description": "Whether the most recent push must be approved by someone other than the person who pushed it",
-                "type": "boolean"
-              },
-              "required_approving_review_count": {
-                "type": "integer"
-              },
-              "required_conversation_resolution_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "required_deployments_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "required_status_checks": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              },
-              "required_status_checks_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "signature_requirement_enforcement_level": {
-                "type": "string",
-                "enum": [
-                  "off",
-                  "non_admins",
-                  "everyone"
-                ]
-              },
-              "strict_required_status_checks_policy": {
-                "type": "boolean"
-              },
-              "updated_at": {
-                "type": "string",
-                "format": "date-time"
-              }
-            },
-            "required": [
-              "id",
-              "repository_id",
-              "name",
-              "created_at",
-              "updated_at",
-              "pull_request_reviews_enforcement_level",
-              "required_approving_review_count",
-              "dismiss_stale_reviews_on_push",
-              "require_code_owner_review",
-              "authorized_dismissal_actors_only",
-              "ignore_approvals_from_contributors",
-              "required_status_checks",
-              "required_status_checks_enforcement_level",
-              "strict_required_status_checks_policy",
-              "signature_requirement_enforcement_level",
-              "linear_history_requirement_enforcement_level",
-              "admin_enforced",
-              "allow_force_pushes_enforcement_level",
-              "allow_deletions_enforcement_level",
-              "merge_queue_enforcement_level",
-              "required_deployments_enforcement_level",
-              "required_conversation_resolution_level",
-              "authorized_actors_only",
-              "authorized_actor_names"
-            ]
+            "$ref": "#/components/schemas/webhooks_rule"
           },
           "sender": {
             "$ref": "#/components/schemas/simple-user-webhooks"