@octokit/openapi 11.0.0 → 11.1.1

package/generated/api.github.com.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "11.0.0",
+    "version": "11.1.1",
     "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": {
@@ -2189,6 +2189,7 @@
           "content": {
             "application/json": {
               "schema": {
+                "type": "object",
                 "properties": {
                   "description": {
                     "description": "The description of the gist.",
@@ -2205,29 +2206,20 @@
                     },
                     "type": "object",
                     "additionalProperties": {
-                      "type": "object",
-                      "nullable": true,
-                      "properties": {
-                        "content": {
-                          "description": "The new content of the file.",
-                          "type": "string"
-                        },
-                        "filename": {
-                          "description": "The new filename for the file.",
-                          "type": "string",
-                          "nullable": true
-                        }
-                      },
-                      "anyOf": [
-                        {
-                          "required": [
-                            "content"
-                          ]
-                        },
+                      "oneOf": [
                         {
-                          "required": [
-                            "filename"
-                          ]
+                          "type": "object",
+                          "properties": {
+                            "content": {
+                              "description": "The new content of the file.",
+                              "type": "string"
+                            },
+                            "filename": {
+                              "description": "The new filename for the file.",
+                              "type": "string",
+                              "nullable": true
+                            }
+                          }
                         },
                         {
                           "type": "object",
@@ -2237,19 +2229,6 @@
                     }
                   }
                 },
-                "anyOf": [
-                  {
-                    "required": [
-                      "description"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "files"
-                    ]
-                  }
-                ],
-                "type": "object",
                 "nullable": true
               },
               "examples": {
@@ -14307,10 +14286,9 @@
               "examples": {
                 "default": {
                   "value": {
-                    "id": 21,
                     "name": "super cool ruleset",
                     "target": "branch",
-                    "enforcement": "enabled",
+                    "enforcement": "active",
                     "bypass_actors": [
                       {
                         "actor_id": 234,
@@ -14502,10 +14480,9 @@
               "examples": {
                 "default": {
                   "value": {
-                    "id": 21,
                     "name": "super cool ruleset",
                     "target": "branch",
-                    "enforcement": "enabled",
+                    "enforcement": "active",
                     "bypass_actors": [
                       {
                         "actor_id": 234,
@@ -21954,6 +21931,70 @@
         "x-octokit": {}
       }
     },
+    "/repos/{owner}/{repo}/actions/runs/{run_id}/deployment_protection_rule": {
+      "post": {
+        "summary": "Review custom deployment protection rules for a workflow run",
+        "description": "Approve or reject custom deployment protection rules provided by a GitHub App for a workflow run. For more information, see \"[Using environments for deployment](https://docs.github.com/actions/deployment/targeting-different-environments/using-environments-for-deployment).\"\n\n**Note:** GitHub Apps can only review their own custom deployment protection rules.\nTo approve or reject pending deployments that are waiting for review from a specific person or team, see [`POST /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments`](/rest/actions/workflow-runs#review-pending-deployments-for-a-workflow-run).\n\nGitHub Apps must have read and write permission for **Deployments** to use this endpoint.",
+        "tags": [
+          "actions"
+        ],
+        "operationId": "actions/review-custom-gates-for-run",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/actions/workflow-runs#review-custom-deployment-protection-rules-for-a-workflow-run"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/run-id"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "anyOf": [
+                  {
+                    "$ref": "#/components/schemas/review-custom-gates-comment-required"
+                  },
+                  {
+                    "$ref": "#/components/schemas/review-custom-gates-state-required"
+                  }
+                ]
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "environment_name": "prod-eus",
+                    "state": "approved",
+                    "comment": "All health checks passed."
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "204": {
+            "description": "Response"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "previews": [],
+          "category": "actions",
+          "subcategory": "workflow-runs"
+        },
+        "x-octokit": {}
+      }
+    },
     "/repos/{owner}/{repo}/actions/runs/{run_id}/jobs": {
       "get": {
         "summary": "List jobs for a workflow run",
@@ -29104,7 +29145,7 @@
                     "type": "string"
                   },
                   "location": {
-                    "description": "Location for this codespace. Assigned by IP if not provided",
+                    "description": "The requested location for a new codespace. Best efforts are made to respect this upon creation. Assigned by IP if not provided.",
                     "type": "string"
                   },
                   "client_ip": {
@@ -33996,10 +34037,296 @@
         "x-octokit": {}
       }
     },
+    "/repos/{owner}/{repo}/environments/{environment_name}/deployment_protection_rules": {
+      "get": {
+        "summary": "Get all deployment protection rules for an environment",
+        "description": "Gets all custom deployment protection rules that are enabled for an environment. Anyone with read access to the repository can use this endpoint. If the repository is private and you want to use a personal access token (classic), you must use an access token with the `repo` scope. GitHub Apps and fine-grained personal access tokens must have the `actions:read` permission to use this endpoint. For more information about environments, see \"[Using environments for deployment](https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment).\"\n\nFor more information about the app that is providing this custom deployment rule, see the [documentation for the `GET /apps/{app_slug}` endpoint](https://docs.github.com/rest/apps/apps#get-an-app).",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/get-all-deployment-protection-rules",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/protection-rules#get-all-deployment-protection-rules"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/environment-name"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/owner"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of deployment protection rules",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "total_count": {
+                      "description": "The number of enabled custom deployment protection rules for this environment",
+                      "type": "integer",
+                      "example": 10
+                    },
+                    "custom_deployment_protection_rules": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/deployment-protection-rule"
+                      }
+                    }
+                  },
+                  "example": "../../components/examples/deployment_protection_rules.yaml"
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "protection-rules"
+        },
+        "x-octokit": {}
+      },
+      "post": {
+        "summary": "Create a custom deployment protection rule on an environment",
+        "description": "Enable a custom deployment protection rule for an environment.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. Enabling a custom protection rule requires admin or owner permissions to the repository. GitHub Apps must have the `actions:write` permission to use this endpoint.\n\nFor more information about the app that is providing this custom deployment rule, see the [documentation for the `GET /apps/{app_slug}` endpoint](https://docs.github.com/rest/apps/apps#get-an-app).",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/create-deployment-protection-rule",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/deployment-protection-rules#create-a-deployment-protection-rule"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/environment-name"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/owner"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "integration_id": {
+                    "type": "integer",
+                    "description": "The ID of the custom app that will be enabled on the environment."
+                  }
+                }
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "integration_id": 5
+                  }
+                }
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "The enabled custom deployment protection rule",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/deployment-protection-rule"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/deployment-protection-rule"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "protection-rules"
+        },
+        "x-octokit": {}
+      }
+    },
+    "/repos/{owner}/{repo}/environments/{environment_name}/deployment_protection_rules/apps": {
+      "get": {
+        "summary": "List custom deployment rule integrations available for an environment",
+        "description": "Gets all custom deployment protection rule integrations that are available for an environment. Anyone with read access to the repository can use this endpoint. If the repository is private and you want to use a personal access token (classic), you must use an access token with the `repo` scope. GitHub Apps and fine-grained personal access tokens must have the `actions:read` permission to use this endpoint.\n\nFor more information about environments, see \"[Using environments for deployment](https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment).\"\n\nFor more information about the app that is providing this custom deployment rule, see \"[GET an app](https://docs.github.com/rest/apps/apps#get-an-app)\".",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/list-custom-deployment-rule-integrations",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/protection-rules#list-custom-deployment-rule-integrations"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/environment-name"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/page"
+          },
+          {
+            "$ref": "#/components/parameters/per-page"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A list of custom deployment rule integrations available for this environment.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "total_count": {
+                      "description": "The total number of custom deployment protection rule integrations available for this environment.",
+                      "type": "integer",
+                      "example": 35
+                    },
+                    "available_custom_deployment_protection_rule_integrations": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/custom-deployment-rule-app"
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/custom-deployment-protection-rule-apps"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "protection-rules"
+        },
+        "x-octokit": {}
+      }
+    },
+    "/repos/{owner}/{repo}/environments/{environment_name}/deployment_protection_rules/{protection_rule_id}": {
+      "get": {
+        "summary": "Get a custom deployment protection rule",
+        "description": "Gets an enabled custom deployment protection rule for an environment. Anyone with read access to the repository can use this endpoint. If the repository is private and you want to use a personal access token (classic), you must use an access token with the `repo` scope. GitHub Apps and fine-grained personal access tokens must have the `actions:read` permission to use this endpoint. For more information about environments, see \"[Using environments for deployment](https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment).\"\n\nFor more information about the app that is providing this custom deployment rule, see [`GET /apps/{app_slug}`](https://docs.github.com/rest/apps/apps#get-an-app).",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/get-custom-deployment-protection-rule",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/protection-rules#get-a-deployment-protection-rule"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/environment-name"
+          },
+          {
+            "$ref": "#/components/parameters/protection-rule-id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/deployment-protection-rule"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/deployment-protection-rule"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "protection-rules"
+        },
+        "x-octokit": {}
+      },
+      "delete": {
+        "summary": "Disable a custom protection rule for an environment",
+        "description": "Disables a custom deployment protection rule for an environment.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. Removing a custom protection rule requires admin or owner permissions to the repository. GitHub Apps must have the `actions:write` permission to use this endpoint. For more information, see \"[Get an app](https://docs.github.com/rest/apps/apps#get-an-app)\".",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/disable-deployment-protection-rule",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/protection-rules#disable-deployment-protection-rule"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/environment-name"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/protection-rule-id"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Response"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "protection-rules"
+        },
+        "x-octokit": {}
+      }
+    },
     "/repos/{owner}/{repo}/events": {
       "get": {
         "summary": "List repository events",
-        "description": "",
+        "description": "**Note**: This API is not built to serve real-time use cases. Depending on the time of day, event latency can be anywhere from 30s to 6h.\n",
         "tags": [
           "activity"
         ],
@@ -36155,7 +36482,7 @@
     "/repos/{owner}/{repo}/import": {
       "get": {
         "summary": "Get an import status",
-        "description": "View the progress of an import.\n\n**Import status**\n\nThis section includes details about the possible values of the `status` field of the Import Progress response.\n\nAn import that does not have errors will progress through these steps:\n\n*   `detecting` - the \"detection\" step of the import is in progress because the request did not include a `vcs` parameter. The import is identifying the type of source control present at the URL.\n*   `importing` - the \"raw\" step of the import is in progress. This is where commit data is fetched from the original repository. The import progress response will include `commit_count` (the total number of raw commits that will be imported) and `percent` (0 - 100, the current progress through the import).\n*   `mapping` - the \"rewrite\" step of the import is in progress. This is where SVN branches are converted to Git branches, and where author updates are applied. The import progress response does not include progress information.\n*   `pushing` - the \"push\" step of the import is in progress. This is where the importer updates the repository on GitHub. The import progress response will include `push_percent`, which is the percent value reported by `git push` when it is \"Writing objects\".\n*   `complete` - the import is complete, and the repository is ready on GitHub.\n\nIf there are problems, you will see one of these in the `status` field:\n\n*   `auth_failed` - the import requires authentication in order to connect to the original repository. To update authentication for the import, please see the [Update an import](https://docs.github.com/rest/migrations/source-imports#update-an-import) section.\n*   `error` - the import encountered an error. The import progress response will include the `failed_step` and an error message. Contact [GitHub Support](https://support.github.com/contact?tags=dotcom-rest-api) for more information.\n*   `detection_needs_auth` - the importer requires authentication for the originating repository to continue detection. To update authentication for the import, please see the [Update an import](https://docs.github.com/rest/migrations/source-imports#update-an-import) section.\n*   `detection_found_nothing` - the importer didn't recognize any source control at the URL. To resolve, [Cancel the import](https://docs.github.com/rest/migrations/source-imports#cancel-an-import) and [retry](https://docs.github.com/rest/migrations/source-imports#start-an-import) with the correct URL.\n*   `detection_found_multiple` - the importer found several projects or repositories at the provided URL. When this is the case, the Import Progress response will also include a `project_choices` field with the possible project choices as values. To update project choice, please see the [Update an import](https://docs.github.com/rest/migrations/source-imports#update-an-import) section.\n\n**The project_choices field**\n\nWhen multiple projects are found at the provided URL, the response hash will include a `project_choices` field, the value of which is an array of hashes each representing a project choice. The exact key/value pairs of the project hashes will differ depending on the version control type.\n\n**Git LFS related fields**\n\nThis section includes details about Git LFS related fields that may be present in the Import Progress response.\n\n*   `use_lfs` - describes whether the import has been opted in or out of using Git LFS. The value can be `opt_in`, `opt_out`, or `undecided` if no action has been taken.\n*   `has_large_files` - the boolean value describing whether files larger than 100MB were found during the `importing` step.\n*   `large_files_size` - the total size in gigabytes of files larger than 100MB found in the originating repository.\n*   `large_files_count` - the total number of files larger than 100MB found in the originating repository. To see a list of these files, make a \"Get Large Files\" request.",
+        "description": "View the progress of an import.\n\n**Warning:** Support for importing Mercurial, Subversion and Team Foundation Version Control repositories will end\non October 17, 2023. For more details, see [changelog](https://gh.io/github-importer-non-git-eol). In the coming weeks, we will update\nthese docs to reflect relevant changes to the API and will contact all integrators using the \"Source imports\" API.\n\n**Import status**\n\nThis section includes details about the possible values of the `status` field of the Import Progress response.\n\nAn import that does not have errors will progress through these steps:\n\n*   `detecting` - the \"detection\" step of the import is in progress because the request did not include a `vcs` parameter. The import is identifying the type of source control present at the URL.\n*   `importing` - the \"raw\" step of the import is in progress. This is where commit data is fetched from the original repository. The import progress response will include `commit_count` (the total number of raw commits that will be imported) and `percent` (0 - 100, the current progress through the import).\n*   `mapping` - the \"rewrite\" step of the import is in progress. This is where SVN branches are converted to Git branches, and where author updates are applied. The import progress response does not include progress information.\n*   `pushing` - the \"push\" step of the import is in progress. This is where the importer updates the repository on GitHub. The import progress response will include `push_percent`, which is the percent value reported by `git push` when it is \"Writing objects\".\n*   `complete` - the import is complete, and the repository is ready on GitHub.\n\nIf there are problems, you will see one of these in the `status` field:\n\n*   `auth_failed` - the import requires authentication in order to connect to the original repository. To update authentication for the import, please see the [Update an import](https://docs.github.com/rest/migrations/source-imports#update-an-import) section.\n*   `error` - the import encountered an error. The import progress response will include the `failed_step` and an error message. Contact [GitHub Support](https://support.github.com/contact?tags=dotcom-rest-api) for more information.\n*   `detection_needs_auth` - the importer requires authentication for the originating repository to continue detection. To update authentication for the import, please see the [Update an import](https://docs.github.com/rest/migrations/source-imports#update-an-import) section.\n*   `detection_found_nothing` - the importer didn't recognize any source control at the URL. To resolve, [Cancel the import](https://docs.github.com/rest/migrations/source-imports#cancel-an-import) and [retry](https://docs.github.com/rest/migrations/source-imports#start-an-import) with the correct URL.\n*   `detection_found_multiple` - the importer found several projects or repositories at the provided URL. When this is the case, the Import Progress response will also include a `project_choices` field with the possible project choices as values. To update project choice, please see the [Update an import](https://docs.github.com/rest/migrations/source-imports#update-an-import) section.\n\n**The project_choices field**\n\nWhen multiple projects are found at the provided URL, the response hash will include a `project_choices` field, the value of which is an array of hashes each representing a project choice. The exact key/value pairs of the project hashes will differ depending on the version control type.\n\n**Git LFS related fields**\n\nThis section includes details about Git LFS related fields that may be present in the Import Progress response.\n\n*   `use_lfs` - describes whether the import has been opted in or out of using Git LFS. The value can be `opt_in`, `opt_out`, or `undecided` if no action has been taken.\n*   `has_large_files` - the boolean value describing whether files larger than 100MB were found during the `importing` step.\n*   `large_files_size` - the total size in gigabytes of files larger than 100MB found in the originating repository.\n*   `large_files_count` - the total number of files larger than 100MB found in the originating repository. To see a list of these files, make a \"Get Large Files\" request.",
         "tags": [
           "migrations"
         ],
@@ -36205,7 +36532,7 @@
       },
       "put": {
         "summary": "Start an import",
-        "description": "Start a source import to a GitHub repository using GitHub Importer. Importing into a GitHub repository with GitHub Actions enabled is not supported and will return a status `422 Unprocessable Entity` response.",
+        "description": "Start a source import to a GitHub repository using GitHub Importer. Importing into a GitHub repository with GitHub Actions enabled is not supported and will return a status `422 Unprocessable Entity` response.\n**Warning:** Support for importing Mercurial, Subversion and Team Foundation Version Control repositories will end on October 17, 2023. For more details, see [changelog](https://gh.io/github-importer-non-git-eol). In the coming weeks, we will update these docs to reflect relevant changes to the API and will contact all integrators using the \"Source imports\" API.",
         "tags": [
           "migrations"
         ],
@@ -36317,7 +36644,7 @@
       },
       "patch": {
         "summary": "Update an import",
-        "description": "An import can be updated with credentials or a project choice by passing in the appropriate parameters in this API\nrequest. If no parameters are provided, the import will be restarted.\n\nSome servers (e.g. TFS servers) can have several projects at a single URL. In those cases the import progress will\nhave the status `detection_found_multiple` and the Import Progress response will include a `project_choices` array.\nYou can select the project to import by providing one of the objects in the `project_choices` array in the update request.",
+        "description": "An import can be updated with credentials or a project choice by passing in the appropriate parameters in this API\nrequest. If no parameters are provided, the import will be restarted.\n\nSome servers (e.g. TFS servers) can have several projects at a single URL. In those cases the import progress will\nhave the status `detection_found_multiple` and the Import Progress response will include a `project_choices` array.\nYou can select the project to import by providing one of the objects in the `project_choices` array in the update request.\n\n**Warning:** Support for importing Mercurial, Subversion and Team Foundation Version Control repositories will end\non October 17, 2023. For more details, see [changelog](https://gh.io/github-importer-non-git-eol). In the coming weeks, we will update\nthese docs to reflect relevant changes to the API and will contact all integrators using the \"Source imports\" API.",
         "tags": [
           "migrations"
         ],
@@ -36427,7 +36754,7 @@
       },
       "delete": {
         "summary": "Cancel an import",
-        "description": "Stop an import for a repository.",
+        "description": "Stop an import for a repository.\n\n**Warning:** Support for importing Mercurial, Subversion and Team Foundation Version Control repositories will end\non October 17, 2023. For more details, see [changelog](https://gh.io/github-importer-non-git-eol). In the coming weeks, we will update\nthese docs to reflect relevant changes to the API and will contact all integrators using the \"Source imports\" API.\n",
         "tags": [
           "migrations"
         ],
@@ -36464,7 +36791,7 @@
     "/repos/{owner}/{repo}/import/authors": {
       "get": {
         "summary": "Get commit authors",
-        "description": "Each type of source control system represents authors in a different way. For example, a Git commit author has a display name and an email address, but a Subversion commit author just has a username. The GitHub Importer will make the author information valid, but the author might not be correct. For example, it will change the bare Subversion username `hubot` into something like `hubot <hubot@12341234-abab-fefe-8787-fedcba987654>`.\n\nThis endpoint and the [Map a commit author](https://docs.github.com/rest/migrations/source-imports#map-a-commit-author) endpoint allow you to provide correct Git author information.",
+        "description": "Each type of source control system represents authors in a different way. For example, a Git commit author has a display name and an email address, but a Subversion commit author just has a username. The GitHub Importer will make the author information valid, but the author might not be correct. For example, it will change the bare Subversion username `hubot` into something like `hubot <hubot@12341234-abab-fefe-8787-fedcba987654>`.\n\nThis endpoint and the [Map a commit author](https://docs.github.com/rest/migrations/source-imports#map-a-commit-author) endpoint allow you to provide correct Git author information.\n\n**Warning:** Support for importing Mercurial, Subversion and Team Foundation Version Control repositories will end\non October 17, 2023. For more details, see [changelog](https://gh.io/github-importer-non-git-eol). In the coming weeks, we will update\nthese docs to reflect relevant changes to the API and will contact all integrators using the \"Source imports\" API.",
         "tags": [
           "migrations"
         ],
@@ -36522,7 +36849,7 @@
     "/repos/{owner}/{repo}/import/authors/{author_id}": {
       "patch": {
         "summary": "Map a commit author",
-        "description": "Update an author's identity for the import. Your application can continue updating authors any time before you push new commits to the repository.",
+        "description": "Update an author's identity for the import. Your application can continue updating authors any time before you push\nnew commits to the repository.\n\n**Warning:** Support for importing Mercurial, Subversion and Team Foundation Version Control repositories will end\non October 17, 2023. For more details, see [changelog](https://gh.io/github-importer-non-git-eol). In the coming weeks, we will update\nthese docs to reflect relevant changes to the API and will contact all integrators using the \"Source imports\" API.\n",
         "tags": [
           "migrations"
         ],
@@ -36614,7 +36941,7 @@
     "/repos/{owner}/{repo}/import/large_files": {
       "get": {
         "summary": "Get large files",
-        "description": "List files larger than 100MB found during the import",
+        "description": "List files larger than 100MB found during the import\n\n**Warning:** Support for importing Mercurial, Subversion and Team Foundation Version Control repositories will end\non October 17, 2023. For more details, see [changelog](https://gh.io/github-importer-non-git-eol). In the coming weeks, we will update\nthese docs to reflect relevant changes to the API and will contact all integrators using the \"Source imports\" API.\n",
         "tags": [
           "migrations"
         ],
@@ -36666,7 +36993,7 @@
     "/repos/{owner}/{repo}/import/lfs": {
       "patch": {
         "summary": "Update Git LFS preference",
-        "description": "You can import repositories from Subversion, Mercurial, and TFS that include files larger than 100MB. This ability is powered by [Git LFS](https://git-lfs.com). You can learn more about our LFS feature and working with large files [on our help site](https://docs.github.com/repositories/working-with-files/managing-large-files).",
+        "description": "You can import repositories from Subversion, Mercurial, and TFS that include files larger than 100MB. This ability\nis powered by [Git LFS](https://git-lfs.com).\n\nYou can learn more about our LFS feature and working with large files [on our help\nsite](https://docs.github.com/repositories/working-with-files/managing-large-files).\n\n**Warning:** Support for importing Mercurial, Subversion and Team Foundation Version Control repositories will end\non October 17, 2023. For more details, see [changelog](https://gh.io/github-importer-non-git-eol). In the coming weeks, we will update\nthese docs to reflect relevant changes to the API and will contact all integrators using the \"Source imports\" API.\n",
         "tags": [
           "migrations"
         ],
@@ -42893,7 +43220,7 @@
                 "nullable": true,
                 "properties": {
                   "location": {
-                    "description": "Location for this codespace. Assigned by IP if not provided",
+                    "description": "The requested location for a new codespace. Best efforts are made to respect this upon creation. Assigned by IP if not provided.",
                     "type": "string"
                   },
                   "client_ip": {
@@ -43738,19 +44065,7 @@
                       "type": "string"
                     }
                   }
-                },
-                "anyOf": [
-                  {
-                    "required": [
-                      "reviewers"
-                    ]
-                  },
-                  {
-                    "required": [
-                      "team_reviewers"
-                    ]
-                  }
-                ]
+                }
               },
               "examples": {
                 "default": {
@@ -46111,10 +46426,9 @@
               "examples": {
                 "default": {
                   "value": {
-                    "id": 42,
                     "name": "super cool ruleset",
                     "target": "branch",
-                    "enforcement": "enabled",
+                    "enforcement": "active",
                     "bypass_mode": "repository",
                     "bypass_actors": [
                       {
@@ -46331,10 +46645,9 @@
               "examples": {
                 "default": {
                   "value": {
-                    "id": 42,
                     "name": "super cool ruleset",
                     "target": "branch",
-                    "enforcement": "enabled",
+                    "enforcement": "active",
                     "bypass_mode": "repository",
                     "bypass_actors": [
                       {
@@ -46995,6 +47308,96 @@
         "x-octokit": {}
       }
     },
+    "/repos/{owner}/{repo}/security-advisories/reports": {
+      "post": {
+        "summary": "Privately report a security vulnerability",
+        "description": "Report a security vulnerability to the maintainers of the repository.\nSee \"[Privately reporting a security vulnerability](https://docs.github.com/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability)\" for more information about private vulnerability reporting.",
+        "tags": [
+          "security-advisories"
+        ],
+        "operationId": "security-advisories/create-private-vulnerability-report",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/security-advisories/repository-advisories#privately-report-a-security-vulnerability"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/private-vulnerability-report-create"
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "summary": "A newly discovered vulnerability",
+                    "description": "A more in-depth description of what the problem is.",
+                    "severity": "high",
+                    "vulnerabilities": [
+                      {
+                        "package": {
+                          "name": "a-package",
+                          "ecosystem": "npm"
+                        },
+                        "vulnerable_version_range": "< 1.0.0",
+                        "patched_versions": "1.0.0",
+                        "vulnerable_functions": [
+                          "important_function"
+                        ]
+                      }
+                    ],
+                    "cwe_ids": [
+                      "CWE-123"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/repository-advisory"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/repository-advisory-pvr"
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "$ref": "#/components/responses/forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          },
+          "422": {
+            "$ref": "#/components/responses/validation_failed"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "security-advisories",
+          "subcategory": "repository-advisories"
+        },
+        "x-octokit": {}
+      }
+    },
     "/repos/{owner}/{repo}/security-advisories/{ghsa_id}": {
       "get": {
         "summary": "Get a repository security advisory",
@@ -49575,7 +49978,7 @@
     "/search/code": {
       "get": {
         "summary": "Search code",
-        "description": "Searches for query terms inside of a file. This method returns up to 100 results [per page](https://docs.github.com/rest/overview/resources-in-the-rest-api#pagination).\n\nWhen searching for code, you can get text match metadata for the file **content** and file **path** fields when you pass the `text-match` media type. For more details about how to receive highlighted search results, see [Text match metadata](https://docs.github.com/rest/reference/search#text-match-metadata).\n\nFor example, if you want to find the definition of the `addClass` function inside [jQuery](https://github.com/jquery/jquery) repository, your query would look something like this:\n\n`q=addClass+in:file+language:js+repo:jquery/jquery`\n\nThis query searches for the keyword `addClass` within a file's contents. The query limits the search to files where the language is JavaScript in the `jquery/jquery` repository.\n\n#### Considerations for code search\n\nDue to the complexity of searching code, there are a few restrictions on how searches are performed:\n\n*   Only the _default branch_ is considered. In most cases, this will be the `master` branch.\n*   Only files smaller than 384 KB are searchable.\n*   You must always include at least one search term when searching source code. For example, searching for [`language:go`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ago&type=Code) is not valid, while [`amazing\nlanguage:go`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ago&type=Code) is.\n\n**Note:** Starting on April 10, 2023, code search on GitHub.com will have a separate\nrate limit from other search types, of 10 requests per minute, and all code\nsearch requests will require authentication. For more information, see [this blog post](https://github.blog/changelog/2023-03-10-changes-to-the-code-search-api/).",
+        "description": "Searches for query terms inside of a file. This method returns up to 100 results [per page](https://docs.github.com/rest/overview/resources-in-the-rest-api#pagination).\n\nWhen searching for code, you can get text match metadata for the file **content** and file **path** fields when you pass the `text-match` media type. For more details about how to receive highlighted search results, see [Text match metadata](https://docs.github.com/rest/reference/search#text-match-metadata).\n\nFor example, if you want to find the definition of the `addClass` function inside [jQuery](https://github.com/jquery/jquery) repository, your query would look something like this:\n\n`q=addClass+in:file+language:js+repo:jquery/jquery`\n\nThis query searches for the keyword `addClass` within a file's contents. The query limits the search to files where the language is JavaScript in the `jquery/jquery` repository.\n\n#### Considerations for code search\n\nDue to the complexity of searching code, there are a few restrictions on how searches are performed:\n\n*   Only the _default branch_ is considered. In most cases, this will be the `master` branch.\n*   Only files smaller than 384 KB are searchable.\n*   You must always include at least one search term when searching source code. For example, searching for [`language:go`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ago&type=Code) is not valid, while [`amazing\nlanguage:go`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ago&type=Code) is.\n\nThis endpoint requires you to authenticate and limits you to 10 requests per minute.",
         "tags": [
           "search"
         ],
@@ -49597,7 +50000,7 @@
           {
             "name": "sort",
             "deprecated": true,
-            "description": "**Note: This field is deprecated, and will be ignored after April 10, 2023 (except on GitHub Enterprise Server).** Sorts the results of your query. Can only be `indexed`, which indicates how recently a file has been indexed by the GitHub search infrastructure. Default: [best match](https://docs.github.com/rest/reference/search#ranking-search-results)",
+            "description": "**This field is deprecated.** Sorts the results of your query. Can only be `indexed`, which indicates how recently a file has been indexed by the GitHub search infrastructure. Default: [best match](https://docs.github.com/rest/reference/search#ranking-search-results)",
             "in": "query",
             "required": false,
             "schema": {
@@ -49609,7 +50012,7 @@
           },
           {
             "name": "order",
-            "description": "**Note: This field is deprecated, and will be ignored after April 10, 2023 (except on GitHub Enterprise Server).** Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`. ",
+            "description": "**This field is deprecated.** Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter is ignored unless you provide `sort`. ",
             "in": "query",
             "deprecated": true,
             "required": false,
@@ -52917,7 +53320,7 @@
                         "type": "string"
                       },
                       "location": {
-                        "description": "Location for this codespace. Assigned by IP if not provided",
+                        "description": "The requested location for a new codespace. Best efforts are made to respect this upon creation. Assigned by IP if not provided.",
                         "type": "string"
                       },
                       "client_ip": {
@@ -52979,7 +53382,7 @@
                         }
                       },
                       "location": {
-                        "description": "Location for this codespace. Assigned by IP if not provided",
+                        "description": "The requested location for a new codespace. Best efforts are made to respect this upon creation. Assigned by IP if not provided.",
                         "type": "string"
                       },
                       "machine": {
@@ -62975,7 +63378,100 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/webhook-dependabot-alert-created"
+                "$ref": "#/components/schemas/webhook-dependabot-alert-created"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Return a 200 status to indicate that the data was received successfully"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "category": "webhooks",
+          "subcategory": "dependabot-alert",
+          "supported-webhook-types": [
+            "repository",
+            "organization",
+            "app"
+          ]
+        }
+      }
+    },
+    "dependabot-alert-dismissed": {
+      "post": {
+        "summary": "This event occurs when there is activity relating to Dependabot alerts.\n\nFor more information about Dependabot alerts, see \"[About Dependabot alerts](https://docs.github.com/code-security/dependabot/dependabot-alerts/about-dependabot-alerts).\" For information about the API to manage Dependabot alerts, see \"[Dependabot alerts](https://docs.github.com/rest/dependabot/alerts)\" in the REST API documentation.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Dependabot alerts\" repository permission.\n\n**Note**: Webhook events for Dependabot alerts are currently in beta and subject to change.",
+        "description": "A Dependabot alert was manually closed.",
+        "operationId": "dependabot-alert/dismissed",
+        "externalDocs": {
+          "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#dependabot-alert"
+        },
+        "parameters": [
+          {
+            "name": "User-Agent",
+            "in": "header",
+            "example": "GitHub-Hookshot/123abc",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "X-Github-Hook-Id",
+            "in": "header",
+            "example": 12312312,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "X-Github-Event",
+            "in": "header",
+            "example": "issues",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "X-Github-Hook-Installation-Target-Id",
+            "in": "header",
+            "example": 123123,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "X-Github-Hook-Installation-Target-Type",
+            "in": "header",
+            "example": "repository",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "X-GitHub-Delivery",
+            "in": "header",
+            "example": "0b989ba4-242f-11e5-81e1-c7b6966d2516",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "X-Hub-Signature-256",
+            "in": "header",
+            "example": "sha256=6dcb09b5b57875f334f61aebed695e2e4193db5e",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/webhook-dependabot-alert-dismissed"
               }
             }
           }
@@ -62997,11 +63493,11 @@
         }
       }
     },
-    "dependabot-alert-dismissed": {
+    "dependabot-alert-fixed": {
       "post": {
         "summary": "This event occurs when there is activity relating to Dependabot alerts.\n\nFor more information about Dependabot alerts, see \"[About Dependabot alerts](https://docs.github.com/code-security/dependabot/dependabot-alerts/about-dependabot-alerts).\" For information about the API to manage Dependabot alerts, see \"[Dependabot alerts](https://docs.github.com/rest/dependabot/alerts)\" in the REST API documentation.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Dependabot alerts\" repository permission.\n\n**Note**: Webhook events for Dependabot alerts are currently in beta and subject to change.",
-        "description": "A Dependabot alert was manually closed.",
-        "operationId": "dependabot-alert/dismissed",
+        "description": "A manifest file change removed a vulnerability.",
+        "operationId": "dependabot-alert/fixed",
         "externalDocs": {
           "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#dependabot-alert"
         },
@@ -63068,7 +63564,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/webhook-dependabot-alert-dismissed"
+                "$ref": "#/components/schemas/webhook-dependabot-alert-fixed"
               }
             }
           }
@@ -63090,11 +63586,11 @@
         }
       }
     },
-    "dependabot-alert-fixed": {
+    "dependabot-alert-reintroduced": {
       "post": {
         "summary": "This event occurs when there is activity relating to Dependabot alerts.\n\nFor more information about Dependabot alerts, see \"[About Dependabot alerts](https://docs.github.com/code-security/dependabot/dependabot-alerts/about-dependabot-alerts).\" For information about the API to manage Dependabot alerts, see \"[Dependabot alerts](https://docs.github.com/rest/dependabot/alerts)\" in the REST API documentation.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Dependabot alerts\" repository permission.\n\n**Note**: Webhook events for Dependabot alerts are currently in beta and subject to change.",
-        "description": "A manifest file change removed a vulnerability.",
-        "operationId": "dependabot-alert/fixed",
+        "description": "A manifest file change introduced a vulnerable dependency that had previously been fixed.",
+        "operationId": "dependabot-alert/reintroduced",
         "externalDocs": {
           "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#dependabot-alert"
         },
@@ -63161,7 +63657,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/webhook-dependabot-alert-fixed"
+                "$ref": "#/components/schemas/webhook-dependabot-alert-reintroduced"
               }
             }
           }
@@ -63183,11 +63679,11 @@
         }
       }
     },
-    "dependabot-alert-reintroduced": {
+    "dependabot-alert-reopened": {
       "post": {
         "summary": "This event occurs when there is activity relating to Dependabot alerts.\n\nFor more information about Dependabot alerts, see \"[About Dependabot alerts](https://docs.github.com/code-security/dependabot/dependabot-alerts/about-dependabot-alerts).\" For information about the API to manage Dependabot alerts, see \"[Dependabot alerts](https://docs.github.com/rest/dependabot/alerts)\" in the REST API documentation.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Dependabot alerts\" repository permission.\n\n**Note**: Webhook events for Dependabot alerts are currently in beta and subject to change.",
-        "description": "A manifest file change introduced a vulnerable dependency that had previously been fixed.",
-        "operationId": "dependabot-alert/reintroduced",
+        "description": "A Dependabot alert was manually reopened.",
+        "operationId": "dependabot-alert/reopened",
         "externalDocs": {
           "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#dependabot-alert"
         },
@@ -63254,7 +63750,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/webhook-dependabot-alert-reintroduced"
+                "$ref": "#/components/schemas/webhook-dependabot-alert-reopened"
               }
             }
           }
@@ -63276,13 +63772,13 @@
         }
       }
     },
-    "dependabot-alert-reopened": {
+    "deploy-key-created": {
       "post": {
-        "summary": "This event occurs when there is activity relating to Dependabot alerts.\n\nFor more information about Dependabot alerts, see \"[About Dependabot alerts](https://docs.github.com/code-security/dependabot/dependabot-alerts/about-dependabot-alerts).\" For information about the API to manage Dependabot alerts, see \"[Dependabot alerts](https://docs.github.com/rest/dependabot/alerts)\" in the REST API documentation.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Dependabot alerts\" repository permission.\n\n**Note**: Webhook events for Dependabot alerts are currently in beta and subject to change.",
-        "description": "A Dependabot alert was manually reopened.",
-        "operationId": "dependabot-alert/reopened",
+        "summary": "This event occurs when there is activity relating to deploy keys. For more information, see \"[Managing deploy keys](https://docs.github.com/developers/overview/managing-deploy-keys).\" For information about the APIs to manage deploy keys, see [the GraphQL API documentation](https://docs.github.com/graphql/reference/objects#deploykey) or \"[Deploy keys](https://docs.github.com/rest/deploy-keys)\" in the REST API documentation.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Deployments\" repository permission.",
+        "description": "A deploy key was created.",
+        "operationId": "deploy-key/created",
         "externalDocs": {
-          "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#dependabot-alert"
+          "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#deploy-key"
         },
         "parameters": [
           {
@@ -63347,7 +63843,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/webhook-dependabot-alert-reopened"
+                "$ref": "#/components/schemas/webhook-deploy-key-created"
               }
             }
           }
@@ -63360,7 +63856,7 @@
         "x-github": {
           "githubCloudOnly": false,
           "category": "webhooks",
-          "subcategory": "dependabot-alert",
+          "subcategory": "deploy-key",
           "supported-webhook-types": [
             "repository",
             "organization",
@@ -63369,11 +63865,11 @@
         }
       }
     },
-    "deploy-key-created": {
+    "deploy-key-deleted": {
       "post": {
-        "summary": "This event occurs when there is activity relating to deploy keys. For more information, see \"[Managing deploy keys](https://docs.github.com/developers/overview/managing-deploy-keys).\" For information about the APIs to manage deploy keys, see [the GraphQL API documentation](https://docs.github.com/graphql/reference/objects#deploykey) or \"[Deploy keys](https://docs.github.com/rest/deploy-keys)\" in the REST API documentation.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Deployments\" repository permission.",
-        "description": "A deploy key was created.",
-        "operationId": "deploy-key/created",
+        "summary": "This event occurs when there is activity relating to deploy keys. For more information, see \"[Managing deploy keys](https://docs.github.com/developers/overview/managing-deploy-keys).\" For information about the APIs to manage deploy keys, see [the GraphQL documentation](https://docs.github.com/graphql/reference/objects#deploykey) or \"[Deploy keys](https://docs.github.com/rest/deploy-keys)\" in the REST API documentation.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Deployments\" repository permission.",
+        "description": "A deploy key was deleted.",
+        "operationId": "deploy-key/deleted",
         "externalDocs": {
           "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#deploy-key"
         },
@@ -63440,7 +63936,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/webhook-deploy-key-created"
+                "$ref": "#/components/schemas/webhook-deploy-key-deleted"
               }
             }
           }
@@ -63462,13 +63958,13 @@
         }
       }
     },
-    "deploy-key-deleted": {
+    "deployment-created": {
       "post": {
-        "summary": "This event occurs when there is activity relating to deploy keys. For more information, see \"[Managing deploy keys](https://docs.github.com/developers/overview/managing-deploy-keys).\" For information about the APIs to manage deploy keys, see [the GraphQL documentation](https://docs.github.com/graphql/reference/objects#deploykey) or \"[Deploy keys](https://docs.github.com/rest/deploy-keys)\" in the REST API documentation.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Deployments\" repository permission.",
-        "description": "A deploy key was deleted.",
-        "operationId": "deploy-key/deleted",
+        "summary": "This event occurs when there is activity relating to deployments. For more information, see \"[About deployments](https://docs.github.com/actions/deployment/about-deployments).\" For information about the APIs to manage deployments, see [the GraphQL API documentation](https://docs.github.com/graphql/reference/objects#deployment) or \"[Deployments](https://docs.github.com/rest/deployments/deployments)\" in the REST API documentation.\n\nFor activity relating to deployment status, use the `deployment_status` event.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Deployments\" repository permission.",
+        "description": "A deployment was created.",
+        "operationId": "deployment/created",
         "externalDocs": {
-          "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#deploy-key"
+          "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#deployment"
         },
         "parameters": [
           {
@@ -63533,7 +64029,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/webhook-deploy-key-deleted"
+                "$ref": "#/components/schemas/webhook-deployment-created"
               }
             }
           }
@@ -63546,7 +64042,7 @@
         "x-github": {
           "githubCloudOnly": false,
           "category": "webhooks",
-          "subcategory": "deploy-key",
+          "subcategory": "deployment",
           "supported-webhook-types": [
             "repository",
             "organization",
@@ -63555,13 +64051,13 @@
         }
       }
     },
-    "deployment-created": {
+    "deployment-protection-rule-requested": {
       "post": {
-        "summary": "This event occurs when there is activity relating to deployments. For more information, see \"[About deployments](https://docs.github.com/actions/deployment/about-deployments).\" For information about the APIs to manage deployments, see [the GraphQL API documentation](https://docs.github.com/graphql/reference/objects#deployment) or \"[Deployments](https://docs.github.com/rest/deployments/deployments)\" in the REST API documentation.\n\nFor activity relating to deployment status, use the `deployment_status` event.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Deployments\" repository permission.",
-        "description": "A deployment was created.",
-        "operationId": "deployment/created",
+        "summary": "This event occurs when there is activity relating to deployment protection rules. For more information, see \"[Using environments for deployment](https://docs.github.com/actions/deployment/targeting-different-environments/using-environments-for-deployment#environment-protection-rules).\" For information about the API to manage deployment protection rules, see [the REST API documentation](https://docs.github.com/rest/deployments/environments).\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Deployments\" repository permission.",
+        "description": "A deployment protection rule was requested for an environment.",
+        "operationId": "deployment-protection-rule/requested",
         "externalDocs": {
-          "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#deployment"
+          "url": "https://docs.github.com/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#deployment_protection_rule"
         },
         "parameters": [
           {
@@ -63626,7 +64122,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/webhook-deployment-created"
+                "$ref": "#/components/schemas/webhook-deployment-protection-rule-requested"
               }
             }
           }
@@ -63639,10 +64135,8 @@
         "x-github": {
           "githubCloudOnly": false,
           "category": "webhooks",
-          "subcategory": "deployment",
+          "subcategory": "deployment-protection-rule",
           "supported-webhook-types": [
-            "repository",
-            "organization",
             "app"
           ]
         }
@@ -89844,7 +90338,7 @@
             }
           },
           "location": {
-            "description": "The Azure region where this codespace is located.",
+            "description": "The initally assigned location of a new codespace.",
             "enum": [
               "EastUs",
               "SouthEastAsia",
@@ -96339,6 +96833,48 @@
           "comment"
         ]
       },
+      "review-custom-gates-comment-required": {
+        "type": "object",
+        "properties": {
+          "environment_name": {
+            "type": "string",
+            "description": "The name of the environment to approve or reject."
+          },
+          "comment": {
+            "type": "string",
+            "description": "Comment associated with the pending deployment protection rule. **Required when state is not provided.**"
+          }
+        },
+        "required": [
+          "environment_name",
+          "comment"
+        ]
+      },
+      "review-custom-gates-state-required": {
+        "type": "object",
+        "properties": {
+          "environment_name": {
+            "type": "string",
+            "description": "The name of the environment to approve or reject."
+          },
+          "state": {
+            "type": "string",
+            "description": "Whether to approve or reject deployment to the specified environments.",
+            "enum": [
+              "approved",
+              "rejected"
+            ]
+          },
+          "comment": {
+            "type": "string",
+            "description": "Optional comment to include with the review."
+          }
+        },
+        "required": [
+          "environment_name",
+          "state"
+        ]
+      },
       "deployment-reviewer-type": {
         "type": "string",
         "description": "The type of reviewer.",
@@ -98872,8 +99408,13 @@
             "items": {
               "type": "string",
               "enum": [
+                "c",
+                "cpp",
+                "csharp",
                 "go",
+                "java",
                 "javascript",
+                "kotlin",
                 "python",
                 "ruby",
                 "typescript"
@@ -102013,6 +102554,70 @@
           "name"
         ]
       },
+      "custom-deployment-rule-app": {
+        "title": "Custom deployment protection rule app",
+        "description": "A GitHub App that is providing a custom deployment protection rule.",
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "example": 3515,
+            "description": "The unique identifier of the deployment protection rule integration."
+          },
+          "slug": {
+            "type": "string",
+            "example": "my-custom-app",
+            "description": "The slugified name of the deployment protection rule integration."
+          },
+          "integration_url": {
+            "type": "string",
+            "example": "https://api.github.com/apps/custom-app-slug",
+            "description": "The URL for the endpoint to get details about the app."
+          },
+          "node_id": {
+            "type": "string",
+            "example": "MDQ6R2F0ZTM1MTU=",
+            "description": "The node ID for the deployment protection rule integration."
+          }
+        },
+        "required": [
+          "id",
+          "slug",
+          "integration_url",
+          "node_id"
+        ]
+      },
+      "deployment-protection-rule": {
+        "title": "Deployment protection rule",
+        "description": "Deployment protection rule",
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "example": 3515,
+            "description": "The unique identifier for the deployment protection rule."
+          },
+          "node_id": {
+            "type": "string",
+            "example": "MDQ6R2F0ZTM1MTU=",
+            "description": "The node ID for the deployment protection rule."
+          },
+          "enabled": {
+            "type": "boolean",
+            "example": true,
+            "description": "Whether the deployment protection rule is enabled for the environment."
+          },
+          "app": {
+            "$ref": "#/components/schemas/custom-deployment-rule-app"
+          }
+        },
+        "required": [
+          "id",
+          "node_id",
+          "enabled",
+          "app"
+        ]
+      },
       "short-blob": {
         "title": "Short Blob",
         "description": "Short Blob",
@@ -108663,28 +109268,122 @@
               "type": "string"
             }
           },
-          "credits": {
-            "type": "array",
-            "description": "A list of users receiving credit for their participation in the security advisory.",
-            "nullable": true,
-            "items": {
-              "type": "object",
-              "properties": {
-                "login": {
-                  "type": "string",
-                  "description": "The username of the user credited."
-                },
-                "type": {
-                  "$ref": "#/components/schemas/repository-advisory-credit-types"
-                }
-              },
-              "required": [
-                "login",
-                "type"
-              ],
-              "additionalProperties": false
-            }
-          },
+          "credits": {
+            "type": "array",
+            "description": "A list of users receiving credit for their participation in the security advisory.",
+            "nullable": true,
+            "items": {
+              "type": "object",
+              "properties": {
+                "login": {
+                  "type": "string",
+                  "description": "The username of the user credited."
+                },
+                "type": {
+                  "$ref": "#/components/schemas/repository-advisory-credit-types"
+                }
+              },
+              "required": [
+                "login",
+                "type"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "severity": {
+            "type": "string",
+            "description": "The severity of the advisory. You must choose between setting this field or `cvss_vector_string`.",
+            "nullable": true,
+            "enum": [
+              "critical",
+              "high",
+              "medium",
+              "low"
+            ]
+          },
+          "cvss_vector_string": {
+            "type": "string",
+            "description": "The CVSS vector that calculates the severity of the advisory. You must choose between setting this field or `severity`.",
+            "nullable": true
+          }
+        },
+        "required": [
+          "summary",
+          "description",
+          "vulnerabilities"
+        ],
+        "additionalProperties": false
+      },
+      "private-vulnerability-report-create": {
+        "type": "object",
+        "properties": {
+          "summary": {
+            "type": "string",
+            "description": "A short summary of the advisory.",
+            "maxLength": 1024
+          },
+          "description": {
+            "type": "string",
+            "description": "A detailed description of what the advisory impacts.",
+            "maxLength": 65535
+          },
+          "vulnerabilities": {
+            "type": "array",
+            "description": "An array of products affected by the vulnerability detailed in a repository security advisory.",
+            "nullable": true,
+            "items": {
+              "type": "object",
+              "properties": {
+                "package": {
+                  "description": "The name of the package affected by the vulnerability.",
+                  "type": "object",
+                  "properties": {
+                    "ecosystem": {
+                      "$ref": "#/components/schemas/repository-advisory-ecosystems"
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The unique package name within its ecosystem.",
+                      "nullable": true
+                    }
+                  },
+                  "required": [
+                    "ecosystem"
+                  ]
+                },
+                "vulnerable_version_range": {
+                  "type": "string",
+                  "description": "The range of the package versions affected by the vulnerability.",
+                  "nullable": true
+                },
+                "patched_versions": {
+                  "type": "string",
+                  "description": "The package version(s) that resolve the vulnerability.",
+                  "nullable": true
+                },
+                "vulnerable_functions": {
+                  "type": "array",
+                  "description": "The functions in the package that are affected.",
+                  "nullable": true,
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "package"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "cwe_ids": {
+            "type": "array",
+            "description": "A list of Common Weakness Enumeration (CWE) IDs.",
+            "nullable": true,
+            "items": {
+              "type": "string"
+            }
+          },
           "severity": {
             "type": "string",
             "description": "The severity of the advisory. You must choose between setting this field or `cvss_vector_string`.",
@@ -108704,8 +109403,7 @@
         },
         "required": [
           "summary",
-          "description",
-          "vulnerabilities"
+          "description"
         ],
         "additionalProperties": false
       },
@@ -110893,7 +111591,7 @@
             }
           },
           "location": {
-            "description": "The Azure region where this codespace is located.",
+            "description": "The initally assigned location of a new codespace.",
             "enum": [
               "EastUs",
               "SouthEastAsia",
@@ -119732,6 +120430,52 @@
           "sender"
         ]
       },
+      "webhook-deployment-protection-rule-requested": {
+        "title": "deployment protection rule requested event",
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "requested"
+            ]
+          },
+          "environment": {
+            "description": "The name of the environment that has the deployment protection rule.",
+            "type": "string"
+          },
+          "event": {
+            "description": "The event that triggered the deployment protection rule.",
+            "type": "string"
+          },
+          "deployment_callback_url": {
+            "description": "The URL to review the deployment protection rule.",
+            "type": "string",
+            "format": "uri"
+          },
+          "deployment": {
+            "$ref": "#/components/schemas/deployment"
+          },
+          "pull_requests": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/pull-request"
+            }
+          },
+          "repository": {
+            "$ref": "#/components/schemas/repository"
+          },
+          "organization": {
+            "$ref": "#/components/schemas/organization-simple"
+          },
+          "installation": {
+            "$ref": "#/components/schemas/simple-installation"
+          },
+          "sender": {
+            "$ref": "#/components/schemas/simple-user"
+          }
+        }
+      },
       "webhook-deployment-status-created": {
         "title": "deployment_status created event",
         "type": "object",
@@ -162590,6 +163334,56 @@
           "sender"
         ]
       },
+      "webhook-rubygems-metadata": {
+        "title": "Ruby Gems metadata",
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "readme": {
+            "type": "string"
+          },
+          "homepage": {
+            "type": "string"
+          },
+          "version_info": {
+            "type": "object",
+            "properties": {
+              "version": {
+                "type": "string"
+              }
+            }
+          },
+          "platform": {
+            "type": "string"
+          },
+          "metadata": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
+          },
+          "repo": {
+            "type": "string"
+          },
+          "dependencies": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              }
+            }
+          },
+          "commit_oid": {
+            "type": "string"
+          }
+        }
+      },
       "webhook-package-published": {
         "title": "package published event",
         "type": "object",
@@ -162874,7 +163668,17 @@
                   },
                   "docker_metadata": {
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "tags": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
                   },
                   "draft": {
                     "type": "boolean"
@@ -163304,7 +164108,9 @@
                   },
                   "rubygems_metadata": {
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "$ref": "#/components/schemas/webhook-rubygems-metadata"
+                    }
                   },
                   "source_url": {
                     "type": "string"
@@ -163653,7 +164459,17 @@
                   },
                   "docker_metadata": {
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "tags": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
                   },
                   "draft": {
                     "type": "boolean"
@@ -163673,7 +164489,10 @@
                   },
                   "metadata": {
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": true
+                    }
                   },
                   "name": {
                     "type": "string"
@@ -163885,7 +164704,9 @@
                   },
                   "rubygems_metadata": {
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "$ref": "#/components/schemas/webhook-rubygems-metadata"
+                    }
                   },
                   "source_url": {
                     "type": "string",
@@ -244788,7 +245609,17 @@
                   },
                   "docker_metadata": {
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "tags": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
                   },
                   "draft": {
                     "type": "boolean"
@@ -245207,7 +246038,9 @@
                   },
                   "rubygems_metadata": {
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "$ref": "#/components/schemas/webhook-rubygems-metadata"
+                    }
                   },
                   "summary": {
                     "type": "string"
@@ -245513,7 +246346,16 @@
                   "docker_metadata": {
                     "type": "array",
                     "items": {
-                      "nullable": true
+                      "type": "object",
+                      "nullable": true,
+                      "properties": {
+                        "tags": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        }
+                      }
                     }
                   },
                   "draft": {
@@ -245533,7 +246375,10 @@
                   },
                   "metadata": {
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "type": "object",
+                      "additionalProperties": true
+                    }
                   },
                   "name": {
                     "type": "string"
@@ -245716,7 +246561,9 @@
                   },
                   "rubygems_metadata": {
                     "type": "array",
-                    "items": {}
+                    "items": {
+                      "$ref": "#/components/schemas/webhook-rubygems-metadata"
+                    }
                   },
                   "summary": {
                     "type": "string"
@@ -273076,7 +273923,7 @@
           "target": "branch",
           "source_type": "Organization",
           "source": "my-org",
-          "enforcement": "enabled",
+          "enforcement": "active",
           "bypass_actors": [
             {
               "actor_id": 234,
@@ -281998,6 +282845,42 @@
           "name": "main"
         }
       },
+      "deployment-protection-rule": {
+        "value": {
+          "id": 3,
+          "node_id": "IEH37kRlcGxveW1lbnRTdGF0ddiv",
+          "enabled": true,
+          "app": {
+            "id": 1,
+            "node_id": "GHT58kRlcGxveW1lbnRTdTY!bbcy",
+            "slug": "a-custom-app",
+            "integration_url": "https://api.github.com/apps/a-custom-app"
+          }
+        }
+      },
+      "custom-deployment-protection-rule-apps": {
+        "value": [
+          {
+            "total_count": 2
+          },
+          {
+            "available_custom_deployment_protection_rule_integrations": [
+              {
+                "id": 1,
+                "node_id": "GHT58kRlcGxveW1lbnRTdTY!bbcy",
+                "slug": "a-custom-app",
+                "integration_url": "https://api.github.com/apps/a-custom-app"
+              },
+              {
+                "id": 2,
+                "node_id": "UHVE67RlcGxveW1lbnRTdTY!jfeuy",
+                "slug": "another-custom-app",
+                "integration_url": "https://api.github.com/apps/another-custom-app"
+              }
+            ]
+          }
+        ]
+      },
       "repo-events-items": {
         "value": [
           {
@@ -286756,7 +287639,7 @@
           "target": "branch",
           "source_type": "Repository",
           "source": "monalisa/my-repo",
-          "enforcement": "enabled",
+          "enforcement": "active",
           "bypass_mode": "repository",
           "bypass_actors": [
             {
@@ -287374,6 +288257,112 @@
           ]
         }
       },
+      "repository-advisory-pvr": {
+        "value": {
+          "ghsa_id": "GHSA-abcd-1234-efgh",
+          "cve_id": "CVE-2050-00000",
+          "url": "https://api.github.com/repos/repo/a-package/security-advisories/GHSA-abcd-1234-efgh",
+          "html_url": "https://github.com/repo/a-package/security/advisories/GHSA-abcd-1234-efgh",
+          "summary": "A newly discovered vulnerability",
+          "description": "A more in-depth description of what the problem is.",
+          "severity": "high",
+          "author": {
+            "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
+          },
+          "publisher": null,
+          "identifiers": [
+            {
+              "type": "GHSA",
+              "value": "GHSA-abcd-1234-efgh"
+            },
+            {
+              "type": "CVE",
+              "value": null
+            }
+          ],
+          "state": "triage",
+          "created_at": "2020-01-01T00:00:00Z",
+          "updated_at": "2020-01-02T00:00:00Z",
+          "published_at": null,
+          "closed_at": null,
+          "withdrawn_at": null,
+          "submission": {
+            "accepted": false
+          },
+          "vulnerabilities": [
+            {
+              "package": {
+                "ecosystem": "npm",
+                "name": "a-package"
+              },
+              "vulnerable_version_range": "< 1.0.0",
+              "patched_versions": "1.0.0",
+              "vulnerable_functions": [
+                "important_function"
+              ]
+            }
+          ],
+          "cvss": null,
+          "cwes": [
+            {
+              "cwe_id": "CWE-123",
+              "name": "A CWE"
+            }
+          ],
+          "cwe_ids": [
+            "CWE-123"
+          ],
+          "credits": [
+            {
+              "login": "octocat",
+              "type": "finder"
+            }
+          ],
+          "credits_detailed": [
+            {
+              "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
+              },
+              "type": "finder",
+              "state": "accepted"
+            }
+          ]
+        }
+      },
       "simple-user-items-default-response": {
         "summary": "Default response",
         "value": [
@@ -295325,6 +296314,15 @@
           "type": "integer"
         }
       },
+      "protection-rule-id": {
+        "name": "protection_rule_id",
+        "description": "The unique identifier of the protection rule.",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "integer"
+        }
+      },
       "since-user": {
         "name": "since",
         "description": "A user ID. Only return users with an ID greater than this ID.",