Update OpenAPI Description (#55923)

docs-bot · felicitymay · web-flow · commit 2f968d9edde3 · 2025-06-03T19:02:56.000Z
Co-authored-by: Felicity Chapman &lt;felicitymay@github.com&gt;
diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json
@@ -99,6 +99,15 @@
         "additional-permissions": false,
         "access": "read"
       },
+      {
+        "category": "dependabot",
+        "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "subcategory": "repository-access",
+        "verb": "patch",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "additional-permissions": false,
+        "access": "write"
+      },
       {
         "category": "dependabot",
         "slug": "set-the-default-repository-access-level-for-dependabot",
diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json
@@ -2192,6 +2192,12 @@
       "verb": "get",
       "requestPath": "/organizations/{org}/dependabot/repository-access"
     },
+    {
+      "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "patch",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
     {
       "slug": "set-the-default-repository-access-level-for-dependabot",
       "subcategory": "repository-access",
diff --git a/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json
@@ -119,6 +119,17 @@
         "server-to-server": true,
         "additional-permissions": false
       },
+      {
+        "category": "dependabot",
+        "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "subcategory": "repository-access",
+        "verb": "patch",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "access": "write",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": false
+      },
       {
         "category": "dependabot",
         "slug": "set-the-default-repository-access-level-for-dependabot",
diff --git a/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json b/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json
@@ -1920,6 +1920,12 @@
       "verb": "get",
       "requestPath": "/organizations/{org}/dependabot/repository-access"
     },
+    {
+      "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "patch",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
     {
       "slug": "set-the-default-repository-access-level-for-dependabot",
       "subcategory": "repository-access",
diff --git a/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json b/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json
@@ -2192,6 +2192,12 @@
       "verb": "get",
       "requestPath": "/organizations/{org}/dependabot/repository-access"
     },
+    {
+      "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "patch",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
     {
       "slug": "set-the-default-repository-access-level-for-dependabot",
       "subcategory": "repository-access",
diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json
@@ -291,6 +291,15 @@
         "additional-permissions": false,
         "access": "read"
       },
+      {
+        "category": "dependabot",
+        "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "subcategory": "repository-access",
+        "verb": "patch",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "additional-permissions": false,
+        "access": "write"
+      },
       {
         "category": "dependabot",
         "slug": "set-the-default-repository-access-level-for-dependabot",
diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json
@@ -2230,6 +2230,12 @@
       "verb": "get",
       "requestPath": "/organizations/{org}/dependabot/repository-access"
     },
+    {
+      "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "patch",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
     {
       "slug": "set-the-default-repository-access-level-for-dependabot",
       "subcategory": "repository-access",
diff --git a/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json
@@ -351,6 +351,17 @@
         "server-to-server": true,
         "additional-permissions": false
       },
+      {
+        "category": "dependabot",
+        "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "subcategory": "repository-access",
+        "verb": "patch",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "access": "write",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": false
+      },
       {
         "category": "dependabot",
         "slug": "set-the-default-repository-access-level-for-dependabot",
diff --git a/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json b/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json
@@ -1958,6 +1958,12 @@
       "verb": "get",
       "requestPath": "/organizations/{org}/dependabot/repository-access"
     },
+    {
+      "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "patch",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
     {
       "slug": "set-the-default-repository-access-level-for-dependabot",
       "subcategory": "repository-access",
diff --git a/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json b/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json
@@ -2230,6 +2230,12 @@
       "verb": "get",
       "requestPath": "/organizations/{org}/dependabot/repository-access"
     },
+    {
+      "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "patch",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
     {
       "slug": "set-the-default-repository-access-level-for-dependabot",
       "subcategory": "repository-access",
diff --git a/src/github-apps/lib/config.json b/src/github-apps/lib/config.json
@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "31cc3f663aaf18c192fbccf6ea5d574ef40dbb20"
+  "sha": "bf4af7c248a68067f570e103053a01b1c9725a92"
 }
diff --git a/src/rest/data/fpt-2022-11-28/schema.json b/src/rest/data/fpt-2022-11-28/schema.json
@@ -250692,6 +250692,69 @@
           }
         ]
       },
+      {
+        "serverUrl": "https://api.github.com",
+        "verb": "patch",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "title": "Updates repositories to the list of repositories that organization admins have allowed Dependabot to access when updating dependencies.",
+        "category": "dependabot",
+        "subcategory": "repository-access",
+        "parameters": [
+          {
+            "name": "org",
+            "description": "<p>The organization name. The name is not case sensitive.</p>",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "bodyParameters": [],
+        "progAccess": {
+          "userToServerRest": true,
+          "serverToServer": true,
+          "fineGrainedPat": true,
+          "permissions": [
+            {
+              "\"Administration\" organization permissions": "write"
+            }
+          ]
+        },
+        "codeExamples": [
+          {
+            "key": "204",
+            "request": {
+              "contentType": "application/json",
+              "description": "Example with a 'succeeded' status.",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "parameters": {
+                "org": "ORG"
+              }
+            },
+            "response": {
+              "statusCode": "204",
+              "description": "<p>Response</p>"
+            }
+          }
+        ],
+        "previews": [],
+        "descriptionHTML": "<div class=\"ghd-alert ghd-alert-accent\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nThis operation supports both server-to-server and user-to-server access.\nUnauthorized users will not see the existence of this endpoint.</p>\n</div>",
+        "statusCodes": [
+          {
+            "httpStatusCode": "204",
+            "description": "<p>No Content</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          }
+        ]
+      },
       {
         "serverUrl": "https://api.github.com",
         "verb": "put",
@@ -388784,7 +388847,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>This endpoint allows you to run an inference request attributed to a specific organization. You must be a member of the organization to use this endpoint.\nThe request body should contain the model ID and the messages for the chat completion request.\nThe response will include either a non-streaming or streaming response based on the request parameters.</p>",
+        "descriptionHTML": "<p>This endpoint allows you to run an inference request attributed to a specific organization. You must be a member of the organization and have enabled models to use this endpoint.\nThe token used to authenticate must have the <code>models: read</code> permission if using a fine-grained PAT or GitHub App minted token.\nThe request body should contain the model ID and the messages for the chat completion request. The response will include either a non-streaming or streaming response based on the request parameters.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
@@ -389116,7 +389179,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<p>This endpoint allows you to run an inference request.</p>",
+        "descriptionHTML": "<p>This endpoint allows you to run an inference request. The token used to authenticate must have the <code>models: read</code> permission if using a fine-grained PAT or GitHub App minted token.\nThe request body should contain the model ID and\nthe messages for the chat completion request. The response will include either a non-streaming or streaming response based on the request parameters.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "200",
diff --git a/src/rest/data/ghec-2022-11-28/schema.json b/src/rest/data/ghec-2022-11-28/schema.json
@@ -117933,7 +117933,7 @@
           {
             "name": "advanced_security_product",
             "in": "query",
-            "description": "<p>The security product to get GitHub Advanced Security active committers for. This parameter is required if you have purchased standalone Code Scanning or Secret Protection products to specify which one you want to get the committer information for, otherwise it is not required.</p>",
+            "description": "<p>The security product to get GitHub Advanced Security active committers for.</p>\n<p>For standalone Code Scanning or Secret Protection products, this parameter is required to specify which product you want committer information for. For other plans this parameter cannot be used.</p>",
             "required": false,
             "schema": {
               "type": "string",
@@ -264836,6 +264836,69 @@
           }
         ]
       },
+      {
+        "serverUrl": "https://api.github.com",
+        "verb": "patch",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "title": "Updates repositories to the list of repositories that organization admins have allowed Dependabot to access when updating dependencies.",
+        "category": "dependabot",
+        "subcategory": "repository-access",
+        "parameters": [
+          {
+            "name": "org",
+            "description": "<p>The organization name. The name is not case sensitive.</p>",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "bodyParameters": [],
+        "progAccess": {
+          "userToServerRest": true,
+          "serverToServer": true,
+          "fineGrainedPat": true,
+          "permissions": [
+            {
+              "\"Administration\" organization permissions": "write"
+            }
+          ]
+        },
+        "codeExamples": [
+          {
+            "key": "204",
+            "request": {
+              "contentType": "application/json",
+              "description": "Example with a 'succeeded' status.",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "parameters": {
+                "org": "ORG"
+              }
+            },
+            "response": {
+              "statusCode": "204",
+              "description": "<p>Response</p>"
+            }
+          }
+        ],
+        "previews": [],
+        "descriptionHTML": "<div class=\"ghd-alert ghd-alert-accent\"><p class=\"ghd-alert-title\"><svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon mr-2\" aria-hidden><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"></path></svg>Note</p>\n<p>\nThis operation supports both server-to-server and user-to-server access.\nUnauthorized users will not see the existence of this endpoint.</p>\n</div>",
+        "statusCodes": [
+          {
+            "httpStatusCode": "204",
+            "description": "<p>No Content</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          }
+        ]
+      },
       {
         "serverUrl": "https://api.github.com",
         "verb": "put",
@@ -282300,7 +282363,7 @@
           {
             "name": "advanced_security_product",
             "in": "query",
-            "description": "<p>The security product to get GitHub Advanced Security active committers for. This parameter is required if you have purchased standalone Code Scanning or Secret Protection products to specify which one you want to get the committer information for, otherwise it is not required.</p>",
+            "description": "<p>The security product to get GitHub Advanced Security active committers for.</p>\n<p>For standalone Code Scanning or Secret Protection products, this parameter is required to specify which product you want committer information for. For other plans this parameter cannot be used.</p>",
             "required": false,
             "schema": {
               "type": "string",
diff --git a/src/rest/data/ghes-3.13-2022-11-28/schema.json b/src/rest/data/ghes-3.13-2022-11-28/schema.json
diff --git a/src/rest/data/ghes-3.16-2022-11-28/schema.json b/src/rest/data/ghes-3.16-2022-11-28/schema.json
diff --git a/src/rest/data/ghes-3.17-2022-11-28/schema.json b/src/rest/data/ghes-3.17-2022-11-28/schema.json
diff --git a/src/rest/lib/config.json b/src/rest/lib/config.json
diff --git a/src/webhooks/lib/config.json b/src/webhooks/lib/config.json
