@octokit/openapi 13.0.0 → 13.1.0

package/generated/ghes-3.10.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "13.0.0",
+    "version": "13.1.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": {
@@ -4427,7 +4427,7 @@
       },
       "post": {
         "summary": "Create a new authorization",
-        "description": "**Deprecation Notice:** GitHub Enterprise Server will discontinue the [OAuth Authorizations API](https://docs.github.com/enterprise-server@3.10/rest/oauth-authorizations/oauth-authorizations), which is used by integrations to create personal access tokens and OAuth tokens, and you must now create these tokens using our [web application flow](https://docs.github.com/enterprise-server@3.10/developers/apps/authorizing-oauth-apps#web-application-flow). The [OAuth Authorizations API](https://docs.github.com/enterprise-server@3.10/rest/oauth-authorizations/oauth-authorizations) will be removed on November, 13, 2020. For more information, including scheduled brownouts, see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-auth-endpoint/).\n\n**Warning:** Apps must use the [web application flow](https://docs.github.com/enterprise-server@3.10/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow) to obtain OAuth tokens that work with GitHub Enterprise Server SAML organizations. OAuth tokens created using the Authorizations API will be unable to access GitHub Enterprise Server SAML organizations. For more information, see the [blog post](https://developer.github.com/changes/2019-11-05-deprecated-passwords-and-authorizations-api).\n\nCreates OAuth tokens using [Basic Authentication](https://docs.github.com/enterprise-server@3.10/rest/overview/other-authentication-methods#basic-authentication). If you have two-factor authentication setup, Basic Authentication for this endpoint requires that you use a one-time password (OTP) and your username and password instead of tokens. For more information, see \"[Working with two-factor authentication](https://docs.github.com/enterprise-server@3.10/rest/overview/other-authentication-methods#working-with-two-factor-authentication).\"\n\nTo create tokens for a particular OAuth application using this endpoint, you must authenticate as the user you want to create an authorization for and provide the app's client ID and secret, found on your OAuth application's settings page. If your OAuth application intends to create multiple tokens for one user, use `fingerprint` to differentiate between them.\n\nYou can also create tokens on GitHub Enterprise Server from the [personal access tokens settings](https://github.com/settings/tokens) page. Read more about these tokens in [the GitHub Help documentation](https://docs.github.com/enterprise-server@3.10/articles/creating-an-access-token-for-command-line-use).\n\nOrganizations that enforce SAML SSO require personal access tokens to be allowed. Read more about allowing tokens in [the GitHub Help documentation](https://docs.github.com/enterprise-server@3.10/articles/about-identity-and-access-management-with-saml-single-sign-on).",
+        "description": "**Deprecation Notice:** GitHub Enterprise Server will discontinue the [OAuth Authorizations API](https://docs.github.com/enterprise-server@3.10/rest/oauth-authorizations/oauth-authorizations), which is used by integrations to create personal access tokens and OAuth tokens, and you must now create these tokens using our [web application flow](https://docs.github.com/enterprise-server@3.10/developers/apps/authorizing-oauth-apps#web-application-flow). The [OAuth Authorizations API](https://docs.github.com/enterprise-server@3.10/rest/oauth-authorizations/oauth-authorizations) will be removed on November, 13, 2020. For more information, including scheduled brownouts, see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-auth-endpoint/).\n\n**Warning:** Apps must use the [web application flow](https://docs.github.com/enterprise-server@3.10/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow) to obtain OAuth tokens that work with GitHub Enterprise Server SAML organizations. OAuth tokens created using the Authorizations API will be unable to access GitHub Enterprise Server SAML organizations. For more information, see the [blog post](https://developer.github.com/changes/2019-11-05-deprecated-passwords-and-authorizations-api).\n\nCreates OAuth tokens using [Basic Authentication](https://docs.github.com/enterprise-server@3.10/rest/overview/other-authentication-methods#basic-authentication). If you have two-factor authentication setup, Basic Authentication for this endpoint requires that you use a one-time password (OTP) and your username and password instead of tokens. For more information, see \"[Working with two-factor authentication](https://docs.github.com/enterprise-server@3.10/rest/overview/other-authentication-methods#working-with-two-factor-authentication).\"\n\nTo create tokens for a particular OAuth application using this endpoint, you must authenticate as the user you want to create an authorization for and provide the app's client ID and secret, found on your OAuth application's settings page. If your OAuth application intends to create multiple tokens for one user, use `fingerprint` to differentiate between them.\n\nYou can also create tokens on GitHub Enterprise Server from the [personal access tokens settings](https://github.com/settings/tokens) page. Read more about these tokens in [the GitHub Help documentation](https://docs.github.com/enterprise-server@3.10/articles/creating-an-access-token-for-command-line-use).\n\nOrganizations that enforce SAML SSO require personal access tokens to be allowed. For more information, see \"[About identity and access management with SAML single sign-on](https://docs.github.com/enterprise-server@3.10/enterprise-cloud@latest/organizations/managing-saml-single-sign-on-for-your-organization/about-identity-and-access-management-with-saml-single-sign-on)\" in the GitHub Enterprise Cloud documentation.",
         "tags": [
           "oauth-authorizations"
         ],
@@ -17716,7 +17716,7 @@
       },
       "post": {
         "summary": "Start an organization migration",
-        "description": "Initiates the generation of a migration archive.",
+        "description": "Initiates the generation of a migration archive.\n\nBefore you can use this endpoint, you must configure a blob storage provider in the \"Migrations\" section in the Management Console. For more details, see \"[Migrating repositories from GitHub Enterprise Server to GitHub Enterprise Cloud](https://docs.github.com/enterprise-server@3.10/migrations/using-github-enterprise-importer/migrating-repositories-with-github-enterprise-importer/migrating-repositories-from-github-enterprise-server-to-github-enterprise-cloud#step-4-set-up-blob-storage).\"",
         "tags": [
           "migrations"
         ],
@@ -17786,7 +17786,7 @@
                   },
                   "exclude": {
                     "type": "array",
-                    "description": "Exclude related items from being returned in the response in order to improve performance of the request. The array can include any of: `\"repositories\"`.",
+                    "description": "Exclude related items from being returned in the response in order to improve performance of the request.",
                     "items": {
                       "type": "string",
                       "enum": [
@@ -25626,7 +25626,7 @@
     "/repos/{owner}/{repo}/actions/jobs/{job_id}/rerun": {
       "post": {
         "summary": "Re-run a job from a workflow run",
-        "description": "Re-run a job and its dependent jobs in a workflow run.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `actions:write` permission to use this endpoint.",
+        "description": "Re-run a job and its dependent jobs in a workflow run.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `actions:write` permission to use this endpoint.",
         "tags": [
           "actions"
         ],
@@ -25917,7 +25917,7 @@
     "/repos/{owner}/{repo}/actions/organization-variables": {
       "get": {
         "summary": "List repository organization variables",
-        "description": "Lists all organiation variables shared with a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `actions_variables:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Lists all organiation variables shared with a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `actions_variables:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -26390,7 +26390,7 @@
     "/repos/{owner}/{repo}/actions/runners": {
       "get": {
         "summary": "List self-hosted runners for a repository",
-        "description": "Lists all self-hosted runners configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Lists all self-hosted runners configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -26462,7 +26462,7 @@
     "/repos/{owner}/{repo}/actions/runners/downloads": {
       "get": {
         "summary": "List runner applications for a repository",
-        "description": "Lists binaries for the runner application that you can download and run.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Lists binaries for the runner application that you can download and run.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -26511,7 +26511,7 @@
     "/repos/{owner}/{repo}/actions/runners/generate-jitconfig": {
       "post": {
         "summary": "Create configuration for a just-in-time runner for a repository",
-        "description": "Generates a configuration that can be passed to the runner application at startup.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Generates a configuration that can be passed to the runner application at startup.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -26605,7 +26605,7 @@
     "/repos/{owner}/{repo}/actions/runners/registration-token": {
       "post": {
         "summary": "Create a registration token for a repository",
-        "description": "Returns a token that you can pass to the `config` script. The token\nexpires after one hour.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.\n\nExample using registration token: \n\nConfigure your self-hosted runner, replacing `TOKEN` with the registration token provided\nby this endpoint.\n\n```config.sh --url https://github.com/octo-org/octo-repo-artifacts --token TOKEN```",
+        "description": "Returns a token that you can pass to the `config` script. The token\nexpires after one hour.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.\n\nExample using registration token:\n\nConfigure your self-hosted runner, replacing `TOKEN` with the registration token provided\nby this endpoint.\n\n```config.sh --url https://github.com/octo-org/octo-repo-artifacts --token TOKEN```",
         "tags": [
           "actions"
         ],
@@ -26651,7 +26651,7 @@
     "/repos/{owner}/{repo}/actions/runners/remove-token": {
       "post": {
         "summary": "Create a remove token for a repository",
-        "description": "Returns a token that you can pass to remove a self-hosted runner from\na repository. The token expires after one hour.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.\n\nExample using remove token:\n\nTo remove your self-hosted runner from a repository, replace TOKEN with\nthe remove token provided by this endpoint.\n\n```config.sh remove --token TOKEN```",
+        "description": "Returns a token that you can pass to remove a self-hosted runner from\na repository. The token expires after one hour.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.\n\nExample using remove token:\n\nTo remove your self-hosted runner from a repository, replace TOKEN with\nthe remove token provided by this endpoint.\n\n```config.sh remove --token TOKEN```",
         "tags": [
           "actions"
         ],
@@ -26697,7 +26697,7 @@
     "/repos/{owner}/{repo}/actions/runners/{runner_id}": {
       "get": {
         "summary": "Get a self-hosted runner for a repository",
-        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Gets a specific self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -26744,7 +26744,7 @@
       },
       "delete": {
         "summary": "Delete a self-hosted runner from a repository",
-        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Forces the removal of a self-hosted runner from a repository. You can use this endpoint to completely remove the runner when the machine you were using no longer exists.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -26781,7 +26781,7 @@
     "/repos/{owner}/{repo}/actions/runners/{runner_id}/labels": {
       "get": {
         "summary": "List labels for a self-hosted runner for a repository",
-        "description": "Lists all labels for a self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Lists all labels for a self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -26819,7 +26819,7 @@
       },
       "post": {
         "summary": "Add custom labels to a self-hosted runner for a repository",
-        "description": "Add custom labels to a self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Add custom labels to a self-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -26894,7 +26894,7 @@
       },
       "put": {
         "summary": "Set custom labels for a self-hosted runner for a repository",
-        "description": "Remove all previous custom labels and set the new custom labels for a specific\nself-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Remove all previous custom labels and set the new custom labels for a specific\nself-hosted runner configured in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -26969,7 +26969,7 @@
       },
       "delete": {
         "summary": "Remove all custom labels from a self-hosted runner for a repository",
-        "description": "Remove all custom labels from a self-hosted runner configured in a\nrepository. Returns the remaining read-only labels from the runner.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Remove all custom labels from a self-hosted runner configured in a\nrepository. Returns the remaining read-only labels from the runner.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -27009,7 +27009,7 @@
     "/repos/{owner}/{repo}/actions/runners/{runner_id}/labels/{name}": {
       "delete": {
         "summary": "Remove a custom label from a self-hosted runner for a repository",
-        "description": "Remove a custom label from a self-hosted runner configured\nin a repository. Returns the remaining labels from the runner.\n\nThis endpoint returns a `404 Not Found` status if the custom label is not\npresent on the runner.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
+        "description": "Remove a custom label from a self-hosted runner configured\nin a repository. Returns the remaining labels from the runner.\n\nThis endpoint returns a `404 Not Found` status if the custom label is not\npresent on the runner.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `administration` permission for repositories and the `organization_self_hosted_runners` permission for organizations.\nAuthenticated users must have admin access to repositories or organizations, or the `manage_runners:enterprise` scope for enterprises, to use these endpoints.",
         "tags": [
           "actions"
         ],
@@ -27552,7 +27552,7 @@
     "/repos/{owner}/{repo}/actions/runs/{run_id}/cancel": {
       "post": {
         "summary": "Cancel a workflow run",
-        "description": "Cancels a workflow run using its `id`.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `actions:write` permission to use this endpoint.",
+        "description": "Cancels a workflow run using its `id`.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `actions:write` permission to use this endpoint.",
         "tags": [
           "actions"
         ],
@@ -28424,7 +28424,7 @@
     "/repos/{owner}/{repo}/actions/variables": {
       "get": {
         "summary": "List repository variables",
-        "description": "Lists all repository variables.\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `actions_variables:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Lists all repository variables.\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `actions_variables:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -28494,7 +28494,7 @@
       },
       "post": {
         "summary": "Create a repository variable",
-        "description": "Creates a repository variable that you can reference in a GitHub Actions workflow.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `actions_variables:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Creates a repository variable that you can reference in a GitHub Actions workflow.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `actions_variables:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -28572,7 +28572,7 @@
     "/repos/{owner}/{repo}/actions/variables/{name}": {
       "get": {
         "summary": "Get a repository variable",
-        "description": "Gets a specific variable in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `actions_variables:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Gets a specific variable in a repository.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `actions_variables:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -28619,7 +28619,7 @@
       },
       "patch": {
         "summary": "Update a repository variable",
-        "description": "Updates a repository variable that you can reference in a GitHub Actions workflow.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `actions_variables:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Updates a repository variable that you can reference in a GitHub Actions workflow.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `actions_variables:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -28682,7 +28682,7 @@
       },
       "delete": {
         "summary": "Delete a repository variable",
-        "description": "Deletes a repository variable using the variable name.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `actions_variables:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Deletes a repository variable using the variable name.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `actions_variables:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -32662,7 +32662,7 @@
       },
       "patch": {
         "summary": "Update a check run",
-        "description": "**Note:** The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array.\n\nUpdates a check run for a specific commit in a repository. Your GitHub App must have the `checks:write` permission to edit check runs.",
+        "description": "Updates a check run for a specific commit in a repository. Your GitHub App must have the `checks:write` permission to edit check runs.\n\n**Note:** The endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array.",
         "tags": [
           "checks"
         ],
@@ -33335,7 +33335,7 @@
     "/repos/{owner}/{repo}/check-suites/{check_suite_id}/check-runs": {
       "get": {
         "summary": "List check runs in a check suite",
-        "description": "**Note:** The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array.\n\nLists check runs for a check suite using its `id`. GitHub Apps must have the `checks:read` permission on a private repository or pull access to a public repository to get check runs. OAuth apps and authenticated users must have the `repo` scope to get check runs in a private repository.",
+        "description": "Lists check runs for a check suite using its `id`. GitHub Apps must have the `checks:read` permission on a private repository or pull access to a public repository to get check runs. OAuth apps and authenticated users must have the `repo` scope to get check runs in a private repository.\n\n**Note:** The endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array.",
         "tags": [
           "checks"
         ],
@@ -34202,7 +34202,7 @@
             }
           },
           "403": {
-            "$ref": "#/components/responses/code_scanning_forbidden_read"
+            "$ref": "#/components/responses/code_scanning_forbidden_write"
           },
           "404": {
             "$ref": "#/components/responses/not_found"
@@ -35678,7 +35678,7 @@
     "/repos/{owner}/{repo}/commits/{ref}/check-runs": {
       "get": {
         "summary": "List check runs for a Git reference",
-        "description": "**Note:** The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array.\n\nLists check runs for a commit ref. The `ref` can be a SHA, branch name, or a tag name. GitHub Apps must have the `checks:read` permission on a private repository or pull access to a public repository to get check runs. OAuth apps and authenticated users must have the `repo` scope to get check runs in a private repository.",
+        "description": "Lists check runs for a commit ref. The `ref` can be a SHA, branch name, or a tag name. GitHub Apps must have the `checks:read` permission on a private repository or pull access to a public repository to get check runs. OAuth apps and authenticated users must have the `repo` scope to get check runs in a private repository.\n\n**Note:** The endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array.\n\nIf there are more than 1000 check suites on a single git reference, this endpoint will limit check runs to the 1000 most recent check suites. To iterate over all possible check runs, use the [List check suites for a Git reference](https://docs.github.com/enterprise-server@3.10/rest/reference/checks#list-check-suites-for-a-git-reference) endpoint and provide the `check_suite_id` parameter to the [List check runs in a check suite](https://docs.github.com/enterprise-server@3.10/rest/reference/checks#list-check-runs-in-a-check-suite) endpoint.",
         "tags": [
           "checks"
         ],
@@ -35781,7 +35781,7 @@
     "/repos/{owner}/{repo}/commits/{ref}/check-suites": {
       "get": {
         "summary": "List check suites for a Git reference",
-        "description": "**Note:** The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array and a `null` value for `head_branch`.\n\nLists check suites for a commit `ref`. The `ref` can be a SHA, branch name, or a tag name. GitHub Apps must have the `checks:read` permission on a private repository or pull access to a public repository to list check suites. OAuth apps and authenticated users must have the `repo` scope to get check suites in a private repository.",
+        "description": "Lists check suites for a commit `ref`. The `ref` can be a SHA, branch name, or a tag name. GitHub Apps must have the `checks:read` permission on a private repository or pull access to a public repository to list check suites. OAuth apps and authenticated users must have the `repo` scope to get check suites in a private repository.\n\n**Note:** The endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array and a `null` value for `head_branch`.",
         "tags": [
           "checks"
         ],
@@ -38389,7 +38389,7 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/deployment-branch-policy-name-pattern"
+                "$ref": "#/components/schemas/deployment-branch-policy-name-pattern-with-type"
               },
               "examples": {
                 "example-wildcard": {
@@ -38446,7 +38446,7 @@
     "/repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies/{branch_policy_id}": {
       "get": {
         "summary": "Get a deployment branch policy",
-        "description": "Gets a deployment branch policy for an environment.\n\nAnyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint.",
+        "description": "Gets a deployment branch policy for an environment.\n\nAnyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the `repo` scope. GitHub Apps must have the `administration:read` permission for the repository to use this endpoint.",
         "tags": [
           "repos"
         ],
@@ -46820,7 +46820,7 @@
     "/repos/{owner}/{repo}/pulls/comments/{comment_id}/reactions": {
       "get": {
         "summary": "List reactions for a pull request review comment",
-        "description": "List the reactions to a [pull request review comment](https://docs.github.com/enterprise-server@3.10/pulls/comments#get-a-review-comment-for-a-pull-request).",
+        "description": "List the reactions to a [pull request review comment](https://docs.github.com/enterprise-server@3.10/rest/pulls/comments#get-a-review-comment-for-a-pull-request).",
         "tags": [
           "reactions"
         ],
@@ -52411,7 +52411,7 @@
     "/repositories/{repository_id}/environments/{environment_name}/variables": {
       "get": {
         "summary": "List environment variables",
-        "description": "Lists all environment variables.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `environments:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Lists all environment variables.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `environments:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -52481,7 +52481,7 @@
       },
       "post": {
         "summary": "Create an environment variable",
-        "description": "Create an environment variable that you can reference in a GitHub Actions workflow.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `environment:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Create an environment variable that you can reference in a GitHub Actions workflow.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `environment:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -52559,7 +52559,7 @@
     "/repositories/{repository_id}/environments/{environment_name}/variables/{name}": {
       "get": {
         "summary": "Get an environment variable",
-        "description": "Gets a specific variable in an environment.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `environments:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Gets a specific variable in an environment.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `environments:read` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -52606,7 +52606,7 @@
       },
       "patch": {
         "summary": "Update an environment variable",
-        "description": "Updates an environment variable that you can reference in a GitHub Actions workflow.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `environment:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Updates an environment variable that you can reference in a GitHub Actions workflow.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `environment:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -52669,7 +52669,7 @@
       },
       "delete": {
         "summary": "Delete an environment variable",
-        "description": "Deletes an environment variable using the variable name.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nIf the repository is private, you must use an access token with the `repo` scope.\nGitHub Apps must have the `environment:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
+        "description": "Deletes an environment variable using the variable name.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint.\nGitHub Apps must have the `environment:write` repository permission to use this endpoint.\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.",
         "tags": [
           "actions"
         ],
@@ -86937,7 +86937,7 @@
           }
         },
         "x-github": {
-          "githubCloudOnly": false,
+          "githubCloudOnly": true,
           "category": "webhooks",
           "subcategory": "user",
           "supported-webhook-types": [
@@ -87044,7 +87044,7 @@
           }
         },
         "x-github": {
-          "githubCloudOnly": false,
+          "githubCloudOnly": true,
           "category": "webhooks",
           "subcategory": "user",
           "supported-webhook-types": [
@@ -101544,7 +101544,6 @@
           "forks",
           "forks_count",
           "git_url",
-          "has_downloads",
           "has_issues",
           "has_projects",
           "has_wiki",
@@ -104982,7 +104981,7 @@
             ]
           },
           "languages": {
-            "description": "Languages to be analysed.",
+            "description": "Languages to be analyzed.",
             "type": "array",
             "items": {
               "type": "string",
@@ -105038,7 +105037,7 @@
             ]
           },
           "languages": {
-            "description": "CodeQL languages to be analyzed. Supported values are: `c-cpp`, `csharp`, `go`, `java-kotlin`, `javascript-typescript`, `python`, and `ruby`.",
+            "description": "CodeQL languages to be analyzed.",
             "type": "array",
             "items": {
               "type": "string",
@@ -107861,6 +107860,20 @@
           }
         }
       },
+      "deployment-branch-policy-name-pattern-with-type": {
+        "title": "Deployment branch and tag policy name pattern",
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "The name pattern that branches or tags must match in order to deploy to the environment.\n\nWildcard characters will not match `/`. For example, to match branches that begin with `release/` and contain an additional single slash, use `release/*/*`.\nFor more information about pattern matching syntax, see the [Ruby File.fnmatch documentation](https://ruby-doc.org/core-2.5.1/File.html#method-c-fnmatch).",
+            "type": "string",
+            "example": "release/*"
+          }
+        },
+        "required": [
+          "name"
+        ]
+      },
       "deployment-branch-policy-name-pattern": {
         "title": "Deployment branch policy name pattern",
         "type": "object",
@@ -121546,7 +121559,7 @@
                 "format": "uri"
               },
               "conclusion": {
-                "description": "The summary conclusion for all check runs that are part of the check suite. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`, `action_required` or `stale`. This value will be `null` until the check run has `completed`.",
+                "description": "The summary conclusion for all check runs that are part of the check suite. This value will be `null` until the check run has `completed`.",
                 "type": "string",
                 "nullable": true,
                 "enum": [
@@ -122327,7 +122340,7 @@
                 "format": "uri"
               },
               "conclusion": {
-                "description": "The summary conclusion for all check runs that are part of the check suite. Can be one of `success`, `failure`,` neutral`, `cancelled`, `timed_out`, `action_required` or `stale`. This value will be `null` until the check run has completed.",
+                "description": "The summary conclusion for all check runs that are part of the check suite. This value will be `null` until the check run has completed.",
                 "type": "string",
                 "nullable": true,
                 "enum": [
@@ -123101,7 +123114,7 @@
                 "format": "uri"
               },
               "conclusion": {
-                "description": "The summary conclusion for all check runs that are part of the check suite. Can be one of `success`, `failure`,` neutral`, `cancelled`, `timed_out`, `action_required` or `stale`. This value will be `null` until the check run has completed.",
+                "description": "The summary conclusion for all check runs that are part of the check suite. This value will be `null` until the check run has completed.",
                 "type": "string",
                 "nullable": true,
                 "enum": [
@@ -123506,7 +123519,7 @@
                 ]
               },
               "dismissed_reason": {
-                "description": "The reason for dismissing or closing the alert. Can be one of: `false positive`, `won't fix`, and `used in tests`.",
+                "description": "The reason for dismissing or closing the alert.",
                 "type": "string",
                 "nullable": true,
                 "enum": [
@@ -123825,7 +123838,7 @@
                 ]
               },
               "dismissed_reason": {
-                "description": "The reason for dismissing or closing the alert. Can be one of: `false positive`, `won't fix`, and `used in tests`.",
+                "description": "The reason for dismissing or closing the alert.",
                 "type": "string",
                 "nullable": true,
                 "enum": [
@@ -124432,7 +124445,7 @@
                 ]
               },
               "dismissed_reason": {
-                "description": "The reason for dismissing or closing the alert. Can be one of: `false positive`, `won't fix`, and `used in tests`.",
+                "description": "The reason for dismissing or closing the alert.",
                 "type": "string",
                 "nullable": true,
                 "enum": [
@@ -130853,7 +130866,7 @@
                 "format": "date-time"
               },
               "conclusion": {
-                "description": "The result of the completed check run. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`, `action_required` or `stale`. This value will be `null` until the check run has completed.",
+                "description": "The result of the completed check run. This value will be `null` until the check run has completed.",
                 "type": "string",
                 "nullable": true,
                 "enum": [
@@ -155682,6 +155695,10 @@
                     "type": "string",
                     "format": "uri"
                   },
+                  "has_discussions": {
+                    "description": "Whether the repository has discussions enabled.",
+                    "type": "boolean"
+                  },
                   "has_downloads": {
                     "description": "Whether downloads are enabled.",
                     "type": "boolean",
@@ -156038,6 +156055,10 @@
                   },
                   "watchers_count": {
                     "type": "integer"
+                  },
+                  "web_commit_signoff_required": {
+                    "description": "Whether to require commit signoff.",
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -279203,7 +279224,7 @@
           "node_id": "MDEyOldvcmtmbG93IEpvYjM5OTQ0NDQ5Ng==",
           "head_sha": "f83a356604ae3c5d03e1b46ef4d1ca77d64a90b0",
           "url": "https://api.github.com/repos/octo-org/octo-repo/actions/jobs/399444496",
-          "html_url": "https://github.com/octo-org/octo-repo/runs/399444496",
+          "html_url": "https://github.com/octo-org/octo-repo/runs/29679449/jobs/399444496",
           "status": "completed",
           "conclusion": "success",
           "started_at": "2020-01-20T17:42:40Z",
@@ -279877,7 +279898,7 @@
               "node_id": "MDEyOldvcmtmbG93IEpvYjM5OTQ0NDQ5Ng==",
               "head_sha": "f83a356604ae3c5d03e1b46ef4d1ca77d64a90b0",
               "url": "https://api.github.com/repos/octo-org/octo-repo/actions/jobs/399444496",
-              "html_url": "https://github.com/octo-org/octo-repo/runs/399444496",
+              "html_url": "https://github.com/octo-org/octo-repo/runs/29679449/jobs/399444496",
               "status": "completed",
               "conclusion": "success",
               "started_at": "2020-01-20T17:42:40Z",
@@ -284967,7 +284988,6 @@
                         "slug": "justice-league",
                         "description": "A great team.",
                         "privacy": "closed",
-                        "notification_setting": "notifications_enabled",
                         "permission": "admin",
                         "members_url": "https://api.github.com/teams/1/members{/member}",
                         "repositories_url": "https://api.github.com/teams/1/repos",
@@ -285045,7 +285065,6 @@
                     "slug": "justice-league",
                     "description": "A great team.",
                     "privacy": "closed",
-                    "notification_setting": "notifications_enabled",
                     "permission": "admin",
                     "members_url": "https://api.github.com/teams/1/members{/member}",
                     "repositories_url": "https://api.github.com/teams/1/repos",
@@ -295511,7 +295530,7 @@
       },
       "hook-id": {
         "name": "hook_id",
-        "description": "The unique identifier of the hook.",
+        "description": "The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery.",
         "in": "path",
         "required": true,
         "schema": {