@octokit/openapi 5.7.0 → 5.9.1

package/generated/ghes-3.2.deref.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "5.7.0",
+    "version": "5.9.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -19788,13 +19788,13 @@
           "category": "enterprise-admin",
           "subcategory": "actions"
         },
-        "x-octokit": {}
+        "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
       }
     },
     "/enterprises/{enterprise}/actions/runner-groups": {
       "get": {
         "summary": "List self-hosted runner groups for an enterprise",
-        "description": "Lists all self-hosted runner groups for an enterprise.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Lists all self-hosted runner groups for an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/list-self-hosted-runner-groups-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -19906,7 +19906,7 @@
       },
       "post": {
         "summary": "Create a self-hosted runner group for an enterprise",
-        "description": "Creates a new self-hosted runner group for an enterprise.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Creates a new self-hosted runner group for an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/create-self-hosted-runner-group-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20021,7 +20021,7 @@
     "/enterprises/{enterprise}/actions/runner-groups/{runner_group_id}": {
       "get": {
         "summary": "Get a self-hosted runner group for an enterprise",
-        "description": "Gets a specific self-hosted runner group for an enterprise.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Gets a specific self-hosted runner group for an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/get-self-hosted-runner-group-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20097,7 +20097,7 @@
       },
       "patch": {
         "summary": "Update a self-hosted runner group for an enterprise",
-        "description": "Updates the `name` and `visibility` of a self-hosted runner group in an enterprise.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Updates the `name` and `visibility` of a self-hosted runner group in an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/update-self-hosted-runner-group-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20198,7 +20198,7 @@
       },
       "delete": {
         "summary": "Delete a self-hosted runner group from an enterprise",
-        "description": "Deletes a self-hosted runner group for an enterprise.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Deletes a self-hosted runner group for an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/delete-self-hosted-runner-group-from-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20235,7 +20235,7 @@
     "/enterprises/{enterprise}/actions/runner-groups/{runner_group_id}/organizations": {
       "get": {
         "summary": "List organization access to a self-hosted runner group in an enterprise",
-        "description": "Lists the organizations with access to a self-hosted runner group.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Lists the organizations with access to a self-hosted runner group.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/list-org-access-to-self-hosted-runner-group-in-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20390,7 +20390,7 @@
       },
       "put": {
         "summary": "Set organization access for a self-hosted runner group in an enterprise",
-        "description": "Replaces the list of organizations that have access to a self-hosted runner configured in an enterprise.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Replaces the list of organizations that have access to a self-hosted runner configured in an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/set-org-access-to-self-hosted-runner-group-in-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20449,7 +20449,7 @@
     "/enterprises/{enterprise}/actions/runner-groups/{runner_group_id}/organizations/{org_id}": {
       "put": {
         "summary": "Add organization access to a self-hosted runner group in an enterprise",
-        "description": "Adds an organization to the list of selected organizations that can access a self-hosted runner group. The runner group must have `visibility` set to `selected`. For more information, see \"[Create a self-hosted runner group for an enterprise](#create-a-self-hosted-runner-group-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Adds an organization to the list of selected organizations that can access a self-hosted runner group. The runner group must have `visibility` set to `selected`. For more information, see \"[Create a self-hosted runner group for an enterprise](#create-a-self-hosted-runner-group-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/add-org-access-to-self-hosted-runner-group-in-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20491,7 +20491,7 @@
       },
       "delete": {
         "summary": "Remove organization access to a self-hosted runner group in an enterprise",
-        "description": "Removes an organization from the list of selected organizations that can access a self-hosted runner group. The runner group must have `visibility` set to `selected`. For more information, see \"[Create a self-hosted runner group for an enterprise](#create-a-self-hosted-runner-group-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Removes an organization from the list of selected organizations that can access a self-hosted runner group. The runner group must have `visibility` set to `selected`. For more information, see \"[Create a self-hosted runner group for an enterprise](#create-a-self-hosted-runner-group-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/remove-org-access-to-self-hosted-runner-group-in-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20535,7 +20535,7 @@
     "/enterprises/{enterprise}/actions/runner-groups/{runner_group_id}/runners": {
       "get": {
         "summary": "List self-hosted runners in a group for an enterprise",
-        "description": "Lists the self-hosted runners that are in a specific enterprise group.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Lists the self-hosted runners that are in a specific enterprise group.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/list-self-hosted-runners-in-group-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20705,7 +20705,7 @@
       },
       "put": {
         "summary": "Set self-hosted runners in a group for an enterprise",
-        "description": "Replaces the list of self-hosted runners that are part of an enterprise runner group.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Replaces the list of self-hosted runners that are part of an enterprise runner group.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/set-self-hosted-runners-in-group-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20764,7 +20764,7 @@
     "/enterprises/{enterprise}/actions/runner-groups/{runner_group_id}/runners/{runner_id}": {
       "put": {
         "summary": "Add a self-hosted runner to a group for an enterprise",
-        "description": "Adds a self-hosted runner to a runner group configured in an enterprise.\n\nYou must authenticate using an access token with the `manage_runners:enterprise`\nscope to use this endpoint.",
+        "description": "Adds a self-hosted runner to a runner group configured in an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise`\nscope to use this endpoint.",
         "operationId": "enterprise-admin/add-self-hosted-runner-to-group-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20806,7 +20806,7 @@
       },
       "delete": {
         "summary": "Remove a self-hosted runner from a group for an enterprise",
-        "description": "Removes a self-hosted runner from a group configured in an enterprise. The runner is then returned to the default group.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Removes a self-hosted runner from a group configured in an enterprise. The runner is then returned to the default group.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/remove-self-hosted-runner-from-group-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -20850,7 +20850,7 @@
     "/enterprises/{enterprise}/actions/runners": {
       "get": {
         "summary": "List self-hosted runners for an enterprise",
-        "description": "Lists all self-hosted runners configured for an enterprise.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Lists all self-hosted runners configured for an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/list-self-hosted-runners-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -21014,7 +21014,7 @@
     "/enterprises/{enterprise}/actions/runners/downloads": {
       "get": {
         "summary": "List runner applications for an enterprise",
-        "description": "Lists binaries for the runner application that you can download and run.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Lists binaries for the runner application that you can download and run.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/list-runner-applications-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -21123,7 +21123,7 @@
     "/enterprises/{enterprise}/actions/runners/registration-token": {
       "post": {
         "summary": "Create a registration token for an enterprise",
-        "description": "Returns a token that you can pass to the `config` script. The token expires after one hour.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.\n\n#### Example using registration token\n\nConfigure your self-hosted runner, replacing `TOKEN` with the registration token provided by this endpoint.\n\n```\n./config.sh --url https://github.com/enterprises/octo-enterprise --token TOKEN\n```",
+        "description": "Returns a token that you can pass to the `config` script. The token expires after one hour.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.\n\n#### Example using registration token\n\nConfigure your self-hosted runner, replacing `TOKEN` with the registration token provided by this endpoint.\n\n```\n./config.sh --url https://github.com/enterprises/octo-enterprise --token TOKEN\n```",
         "operationId": "enterprise-admin/create-registration-token-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -22024,7 +22024,7 @@
     "/enterprises/{enterprise}/actions/runners/remove-token": {
       "post": {
         "summary": "Create a remove token for an enterprise",
-        "description": "Returns a token that you can pass to the `config` script to remove a self-hosted runner from an enterprise. The token expires after one hour.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.\n\n#### Example using remove token\n\nTo remove your self-hosted runner from an enterprise, replace `TOKEN` with the remove token provided by this\nendpoint.\n\n```\n./config.sh remove --token TOKEN\n```",
+        "description": "Returns a token that you can pass to the `config` script to remove a self-hosted runner from an enterprise. The token expires after one hour.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.\n\n#### Example using remove token\n\nTo remove your self-hosted runner from an enterprise, replace `TOKEN` with the remove token provided by this\nendpoint.\n\n```\n./config.sh remove --token TOKEN\n```",
         "operationId": "enterprise-admin/create-remove-token-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -22925,7 +22925,7 @@
     "/enterprises/{enterprise}/actions/runners/{runner_id}": {
       "get": {
         "summary": "Get a self-hosted runner for an enterprise",
-        "description": "Gets a specific self-hosted runner configured in an enterprise.\n\nYou must authenticate using an access token with the `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Gets a specific self-hosted runner configured in an enterprise.\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/get-self-hosted-runner-for-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -23035,7 +23035,7 @@
       },
       "delete": {
         "summary": "Delete a self-hosted runner from an enterprise",
-        "description": "Forces the removal of a self-hosted runner from an enterprise. 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 `manage_runners:enterprise` scope to use this endpoint.",
+        "description": "Forces the removal of a self-hosted runner from an enterprise. 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 `admin:enterprise` scope to use this endpoint.",
         "operationId": "enterprise-admin/delete-self-hosted-runner-from-enterprise",
         "tags": ["enterprise-admin"],
         "externalDocs": {
@@ -44684,7 +44684,7 @@
             }
           ]
         },
-        "x-octokit": {}
+        "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
       }
     },
     "/orgs/{org}/actions/permissions": {
@@ -46047,7 +46047,7 @@
           "category": "actions",
           "subcategory": "permissions"
         },
-        "x-octokit": {}
+        "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
       }
     },
     "/orgs/{org}/actions/runner-groups": {
@@ -90947,7 +90947,7 @@
           "category": "actions",
           "subcategory": "permissions"
         },
-        "x-octokit": {}
+        "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
       }
     },
     "/repos/{owner}/{repo}/actions/runners": {
@@ -93288,6 +93288,13 @@
             "in": "query",
             "required": false,
             "schema": { "type": "string", "format": "date-time" }
+          },
+          {
+            "name": "exclude_pull_requests",
+            "description": "If `true` pull requests are omitted from the response (empty array).",
+            "in": "query",
+            "required": false,
+            "schema": { "type": "boolean", "default": false }
           }
         ],
         "responses": {
@@ -96469,6 +96476,13 @@
             "in": "path",
             "required": true,
             "schema": { "type": "integer" }
+          },
+          {
+            "name": "exclude_pull_requests",
+            "description": "If `true` pull requests are omitted from the response (empty array).",
+            "in": "query",
+            "required": false,
+            "schema": { "type": "boolean", "default": false }
           }
         ],
         "responses": {
@@ -102372,6 +102386,13 @@
             "in": "query",
             "required": false,
             "schema": { "type": "string", "format": "date-time" }
+          },
+          {
+            "name": "exclude_pull_requests",
+            "description": "If `true` pull requests are omitted from the response (empty array).",
+            "in": "query",
+            "required": false,
+            "schema": { "type": "boolean", "default": false }
           }
         ],
         "responses": {
@@ -129454,7 +129475,7 @@
           "previews": [],
           "category": "code-scanning"
         },
-        "x-octokit": {}
+        "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
       }
     },
     "/repos/{owner}/{repo}/code-scanning/alerts/{alert_number}/instances": {
@@ -248067,7 +248088,7 @@
           "category": "repos",
           "subcategory": "releases"
         },
-        "x-octokit": {}
+        "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
       }
     },
     "/repos/{owner}/{repo}/releases/assets/{asset_id}": {
@@ -250671,7 +250692,7 @@
           "category": "repos",
           "subcategory": "releases"
         },
-        "x-octokit": {}
+        "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
       },
       "delete": {
         "summary": "Delete a release",
@@ -251220,6 +251241,9 @@
                 }
               }
             }
+          },
+          "422": {
+            "description": "Response if you upload an asset with the same filename as another uploaded asset"
           }
         },
         "x-github": {
@@ -319564,6 +319588,20 @@
         "responses": { "501": { "description": "Not Implemented" } }
       }
     },
+    "/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/jobs": {
+      "get": {
+        "summary": "List jobs for a workflow run attempt",
+        "description": "This endpoint does not exist ghes-3.2. It was added in api.github.com",
+        "tags": ["actions"],
+        "operationId": "actions/list-jobs-for-workflow-run-attempt",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/actions#list-jobs-for-a-workflow-run-attempt"
+        },
+        "x-octokit": { "api.github.com": "removed" },
+        "responses": { "501": { "description": "Not Implemented" } }
+      }
+    },
     "/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/logs": {
       "get": {
         "summary": "Download workflow run attempt logs",