@octokit/openapi 6.6.1 → 6.7.0

package/generated/ghes-3.5.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "6.6.1",
+    "version": "6.7.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -2941,6 +2941,18 @@
                     "type": "string"
                   }
                 }
+              },
+              "examples": {
+                "default": {
+                  "summary": "Create an authorization",
+                  "value": {
+                    "scopes": ["public_repo"],
+                    "note": "optional note",
+                    "note_url": "http://optional/note/url",
+                    "client_id": "abcde12345fghij67890",
+                    "client_secret": "3ef4ad510c59ad37bac6bb4f80047fb3aee3cc7f"
+                  }
+                }
               }
             }
           }
@@ -2991,7 +3003,7 @@
           "description": "API method documentation",
           "url": "https://docs.github.com/enterprise-server@3.5/rest/reference/oauth-authorizations#get-or-create-an-authorization-for-a-specific-app"
         },
-        "parameters": [{ "$ref": "#/components/parameters/client-id" }],
+        "parameters": [{ "$ref": "#/components/parameters/oauth-client-id" }],
         "requestBody": {
           "required": true,
           "content": {
@@ -3026,6 +3038,17 @@
                 },
                 "required": ["client_secret"],
                 "type": "object"
+              },
+              "examples": {
+                "default": {
+                  "summary": "Create an authorization for an app",
+                  "value": {
+                    "client_secret": "3ef4ad510c59ad37bac6bb4f80047fb3aee3cc7f",
+                    "scopes": ["public_repo"],
+                    "note": "optional note",
+                    "note_url": "http://optional/note/url"
+                  }
+                }
               }
             }
           }
@@ -3095,7 +3118,7 @@
           "url": "https://docs.github.com/enterprise-server@3.5/rest/reference/oauth-authorizations#get-or-create-an-authorization-for-a-specific-app-and-fingerprint"
         },
         "parameters": [
-          { "$ref": "#/components/parameters/client-id" },
+          { "$ref": "#/components/parameters/oauth-client-id" },
           {
             "name": "fingerprint",
             "in": "path",
@@ -3133,6 +3156,17 @@
                 },
                 "required": ["client_secret"],
                 "type": "object"
+              },
+              "examples": {
+                "default": {
+                  "summary": "Create an authorization for an app and fingerprint",
+                  "value": {
+                    "client_secret": "3ef4ad510c59ad37bac6bb4f80047fb3aee3cc7f",
+                    "scopes": ["public_repo"],
+                    "note": "optional note",
+                    "note_url": "http://optional/note/url"
+                  }
+                }
               }
             }
           }
@@ -5408,7 +5442,7 @@
     "/enterprises/{enterprise}/settings/billing/advanced-security": {
       "get": {
         "summary": "Get GitHub Advanced Security active committers for an enterprise",
-        "description": "Gets the GitHub Advanced Security active committers for an enterprise per repository.\nEach distinct user login across all repositories is counted as a single Advanced Security seat, so the total_advanced_security_committers is not the sum of active_users for each repository.",
+        "description": "Gets the GitHub Advanced Security active committers for an enterprise per repository.\n\nEach distinct user login across all repositories is counted as a single Advanced Security seat, so the `total_advanced_security_committers` is not the sum of active_users for each repository.\n\nThe total number of repositories with committer information is tracked by the `total_count` field.",
         "tags": ["billing"],
         "operationId": "billing/get-github-advanced-security-billing-ghe",
         "externalDocs": {
@@ -9484,7 +9518,7 @@
     "/orgs/{org}/code-scanning/alerts": {
       "get": {
         "summary": "List code scanning alerts for an organization",
-        "description": "Lists all code scanning alerts for the default branch (usually `main`\nor `master`) for all eligible repositories in an organization.\nTo use this endpoint, you must be an administrator or security manager for the organization, and you must use an access token with the `repo` scope or `security_events` scope.\n\nGitHub Apps must have the `security_events` read permission to use this endpoint.",
+        "description": "Lists code scanning alerts for the default branch for all eligible repositories in an organization. Eligible repositories are repositories that are owned by organizations that you own or for which you are a security manager. For more information, see \"[Managing security managers in your organization](https://docs.github.com/enterprise-server@3.5/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization).\"\n\nTo use this endpoint, you must be an owner or security manager for the organization, and you must use an access token with the `repo` scope or `security_events` scope.\n\nGitHub Apps must have the `security_events` read permission to use this endpoint.",
         "tags": ["code-scanning"],
         "operationId": "code-scanning/list-alerts-for-org",
         "externalDocs": {
@@ -9502,7 +9536,7 @@
           { "$ref": "#/components/parameters/direction" },
           {
             "name": "state",
-            "description": "Set to `open`, `closed`, `fixed`, or `dismissed` to list code scanning alerts in a specific state.",
+            "description": "If specified, only code scanning alerts with this state will be returned.",
             "in": "query",
             "required": false,
             "schema": {
@@ -12081,7 +12115,7 @@
     "/orgs/{org}/settings/billing/advanced-security": {
       "get": {
         "summary": "Get GitHub Advanced Security active committers for an organization",
-        "description": "Gets the GitHub Advanced Security active committers for an organization per repository.\nEach distinct user login across all repositories is counted as a single Advanced Security seat, so the total_advanced_security_committers is not the sum of advanced_security_committers for each repository.\nIf this organization defers to an enterprise for billing, the total_advanced_security_committers returned from the organization API may include some users that are in more than one organization, so they will only consume a single Advanced Security seat at the enterprise level.",
+        "description": "Gets the GitHub Advanced Security active committers for an organization per repository.\n\nEach distinct user login across all repositories is counted as a single Advanced Security seat, so the `total_advanced_security_committers` is not the sum of advanced_security_committers for each repository.\n\nIf this organization defers to an enterprise for billing, the `total_advanced_security_committers` returned from the organization API may include some users that are in more than one organization, so they will only consume a single Advanced Security seat at the enterprise level.\n\nThe total number of repositories with committer information is tracked by the `total_count` field.",
         "tags": ["billing"],
         "operationId": "billing/get-github-advanced-security-billing-org",
         "externalDocs": {
@@ -23084,11 +23118,8 @@
             "description": "Response when creating a secret",
             "content": {
               "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {},
-                  "additionalProperties": false
-                }
+                "schema": { "$ref": "#/components/schemas/empty-object" },
+                "examples": { "default": { "value": null } }
               }
             }
           },
@@ -30281,7 +30312,7 @@
     "/repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers": {
       "get": {
         "summary": "List requested reviewers for a pull request",
-        "description": "",
+        "description": "Lists the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the [List reviews for a pull request](https://docs.github.com/enterprise-server@3.5/rest/pulls/reviews#list-reviews-for-a-pull-request) operation.",
         "tags": ["pulls"],
         "operationId": "pulls/list-requested-reviewers",
         "externalDocs": {
@@ -40785,6 +40816,20 @@
         "responses": { "501": { "description": "Not Implemented" } }
       }
     },
+    "/repos/{owner}/{repo}/codespaces/new": {
+      "get": {
+        "summary": "Get default attributes for a codespace",
+        "description": "This endpoint does not exist in GitHub Enterprise Server 3.5. It was added in api.github.com",
+        "tags": ["codespaces"],
+        "operationId": "codespaces/pre-flight-with-repo-for-authenticated-user",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/codespaces#preview-attributes-for-a-new-codespace"
+        },
+        "x-octokit": { "api.github.com": "removed" },
+        "responses": { "501": { "description": "Not Implemented" } }
+      }
+    },
     "/repos/{owner}/{repo}/codespaces/secrets": {
       "get": {
         "summary": "List repository secrets",
@@ -79446,6 +79491,14 @@
         "required": true,
         "schema": { "type": "string" }
       },
+      "oauth-client-id": {
+        "name": "client_id",
+        "in": "path",
+        "required": true,
+        "description": "The client ID of the OAuth app.",
+        "schema": { "type": "string" },
+        "examples": { "default": { "value": "abcde12345fghij67890" } }
+      },
       "authorization-id": {
         "name": "authorization_id",
         "description": "The unique identifier of the authorization.",

package/generated/github.ae-anicca-diff-to-api.github.com.deref.json

@@ -9152,6 +9152,7 @@
       "/repos/{owner}/{repo}/codespaces": ["get", "post"],
       "/repos/{owner}/{repo}/codespaces/devcontainers": ["get"],
       "/repos/{owner}/{repo}/codespaces/machines": ["get"],
+      "/repos/{owner}/{repo}/codespaces/new": ["get"],
       "/repos/{owner}/{repo}/codespaces/secrets": ["get"],
       "/repos/{owner}/{repo}/codespaces/secrets/public-key": ["get"],
       "/repos/{owner}/{repo}/codespaces/secrets/{secret_name}": [

package/generated/github.ae-diff-to-api.github.com.deref.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "6.6.1",
+    "version": "6.7.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },

package/generated/github.ae-diff-to-api.github.com.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "6.6.1",
+    "version": "6.7.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },

package/generated/github.ae.deref.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "6.6.1",
+    "version": "6.7.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -233172,7 +233172,7 @@
     "/repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers": {
       "get": {
         "summary": "List requested reviewers for a pull request",
-        "description": "",
+        "description": "Lists the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the [List reviews for a pull request](https://docs.github.com/github-ae@latest/rest/pulls/reviews#list-reviews-for-a-pull-request) operation.",
         "tags": ["pulls"],
         "operationId": "pulls/list-requested-reviewers",
         "externalDocs": {
@@ -310314,6 +310314,20 @@
         "responses": { "501": { "description": "Not Implemented" } }
       }
     },
+    "/repos/{owner}/{repo}/codespaces/new": {
+      "get": {
+        "summary": "Get default attributes for a codespace",
+        "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.",
+        "tags": ["codespaces"],
+        "operationId": "codespaces/pre-flight-with-repo-for-authenticated-user",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/codespaces#preview-attributes-for-a-new-codespace"
+        },
+        "x-octokit": { "api.github.com": "removed" },
+        "responses": { "501": { "description": "Not Implemented" } }
+      }
+    },
     "/repos/{owner}/{repo}/codespaces/secrets": {
       "get": {
         "summary": "List repository secrets",

package/generated/github.ae.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "6.6.1",
+    "version": "6.7.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -25970,7 +25970,7 @@
     "/repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers": {
       "get": {
         "summary": "List requested reviewers for a pull request",
-        "description": "",
+        "description": "Lists the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the [List reviews for a pull request](https://docs.github.com/github-ae@latest/rest/pulls/reviews#list-reviews-for-a-pull-request) operation.",
         "tags": ["pulls"],
         "operationId": "pulls/list-requested-reviewers",
         "externalDocs": {
@@ -35809,6 +35809,20 @@
         "responses": { "501": { "description": "Not Implemented" } }
       }
     },
+    "/repos/{owner}/{repo}/codespaces/new": {
+      "get": {
+        "summary": "Get default attributes for a codespace",
+        "description": "This endpoint is currently not supported by GitHub AE. It only exists in api.github.com right now.",
+        "tags": ["codespaces"],
+        "operationId": "codespaces/pre-flight-with-repo-for-authenticated-user",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/codespaces#preview-attributes-for-a-new-codespace"
+        },
+        "x-octokit": { "api.github.com": "removed" },
+        "responses": { "501": { "description": "Not Implemented" } }
+      }
+    },
     "/repos/{owner}/{repo}/codespaces/secrets": {
       "get": {
         "summary": "List repository secrets",

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "6.6.1",
+  "version": "6.7.0",
   "description": "GitHub's official OpenAPI spec with Octokit extensions",
   "main": "index.js",
   "files": [