Update OpenAPI Description (#56395)

docs-bot · sabrowning1 · web-flow · commit 095c64746473 · 2025-06-30T20:14:59.000Z
Co-authored-by: Sam Browning &lt;106113886+sabrowning1@users.noreply.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
@@ -92,7 +92,7 @@
     "permissions": [
       {
         "category": "dependabot",
-        "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
         "subcategory": "repository-access",
         "verb": "get",
         "requestPath": "/organizations/{org}/dependabot/repository-access",
@@ -101,7 +101,7 @@
       },
       {
         "category": "dependabot",
-        "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "slug": "updates-dependabots-repository-access-list-for-an-organization",
         "subcategory": "repository-access",
         "verb": "patch",
         "requestPath": "/organizations/{org}/dependabot/repository-access",
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
@@ -2187,13 +2187,13 @@
   ],
   "dependabot": [
     {
-      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
       "subcategory": "repository-access",
       "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",
+      "slug": "updates-dependabots-repository-access-list-for-an-organization",
       "subcategory": "repository-access",
       "verb": "patch",
       "requestPath": "/organizations/{org}/dependabot/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
@@ -110,7 +110,7 @@
     "permissions": [
       {
         "category": "dependabot",
-        "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
         "subcategory": "repository-access",
         "verb": "get",
         "requestPath": "/organizations/{org}/dependabot/repository-access",
@@ -121,7 +121,7 @@
       },
       {
         "category": "dependabot",
-        "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "slug": "updates-dependabots-repository-access-list-for-an-organization",
         "subcategory": "repository-access",
         "verb": "patch",
         "requestPath": "/organizations/{org}/dependabot/repository-access",
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
@@ -1915,13 +1915,13 @@
   ],
   "dependabot": [
     {
-      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
       "subcategory": "repository-access",
       "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",
+      "slug": "updates-dependabots-repository-access-list-for-an-organization",
       "subcategory": "repository-access",
       "verb": "patch",
       "requestPath": "/organizations/{org}/dependabot/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
@@ -2187,13 +2187,13 @@
   ],
   "dependabot": [
     {
-      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
       "subcategory": "repository-access",
       "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",
+      "slug": "updates-dependabots-repository-access-list-for-an-organization",
       "subcategory": "repository-access",
       "verb": "patch",
       "requestPath": "/organizations/{org}/dependabot/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
@@ -284,7 +284,7 @@
       },
       {
         "category": "dependabot",
-        "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
         "subcategory": "repository-access",
         "verb": "get",
         "requestPath": "/organizations/{org}/dependabot/repository-access",
@@ -293,7 +293,7 @@
       },
       {
         "category": "dependabot",
-        "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "slug": "updates-dependabots-repository-access-list-for-an-organization",
         "subcategory": "repository-access",
         "verb": "patch",
         "requestPath": "/organizations/{org}/dependabot/repository-access",
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
@@ -2249,13 +2249,13 @@
   ],
   "dependabot": [
     {
-      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
       "subcategory": "repository-access",
       "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",
+      "slug": "updates-dependabots-repository-access-list-for-an-organization",
       "subcategory": "repository-access",
       "verb": "patch",
       "requestPath": "/organizations/{org}/dependabot/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
@@ -342,7 +342,7 @@
       },
       {
         "category": "dependabot",
-        "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
         "subcategory": "repository-access",
         "verb": "get",
         "requestPath": "/organizations/{org}/dependabot/repository-access",
@@ -353,7 +353,7 @@
       },
       {
         "category": "dependabot",
-        "slug": "updates-repositories-to-the-list-of-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "slug": "updates-dependabots-repository-access-list-for-an-organization",
         "subcategory": "repository-access",
         "verb": "patch",
         "requestPath": "/organizations/{org}/dependabot/repository-access",
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
@@ -1977,13 +1977,13 @@
   ],
   "dependabot": [
     {
-      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
       "subcategory": "repository-access",
       "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",
+      "slug": "updates-dependabots-repository-access-list-for-an-organization",
       "subcategory": "repository-access",
       "verb": "patch",
       "requestPath": "/organizations/{org}/dependabot/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
@@ -2249,13 +2249,13 @@
   ],
   "dependabot": [
     {
-      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "slug": "lists-the-repositories-dependabot-can-access-in-an-organization",
       "subcategory": "repository-access",
       "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",
+      "slug": "updates-dependabots-repository-access-list-for-an-organization",
       "subcategory": "repository-access",
       "verb": "patch",
       "requestPath": "/organizations/{org}/dependabot/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": "042ebdf85f1f5234751ac9603b977c9929e72c66"
+  "sha": "c52348cd88be16e613e49c26b39d2653e20b817d"
 }
diff --git a/src/rest/data/fpt-2022-11-28/schema.json b/src/rest/data/fpt-2022-11-28/schema.json
@@ -250296,7 +250296,7 @@
         "serverUrl": "https://api.github.com",
         "verb": "get",
         "requestPath": "/organizations/{org}/dependabot/repository-access",
-        "title": "Lists repositories that organization admins have allowed Dependabot to access when updating dependencies.",
+        "title": "Lists the repositories Dependabot can access in an organization",
         "category": "dependabot",
         "subcategory": "repository-access",
         "parameters": [
@@ -251022,7 +251022,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><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>",
+        "descriptionHTML": "<p>Lists repositories that organization admins have allowed Dependabot to access when updating dependencies.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><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": "200",
@@ -251042,7 +251042,7 @@
         "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.",
+        "title": "Updates Dependabot's repository access list for an organization",
         "category": "dependabot",
         "subcategory": "repository-access",
         "parameters": [
@@ -251098,7 +251098,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><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>\n<p><strong>Example request body:</strong></p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">\"repository_ids_to_add\"</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-number\">123</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-number\">456</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">\"repository_ids_to_remove\"</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-number\">789</span><span class=\"hljs-punctuation\">]</span>\n<span class=\"hljs-punctuation\">}</span>\n</code></pre>",
+        "descriptionHTML": "<p>Updates repositories according to the list of repositories that organization admins have given Dependabot access to when they've updated dependencies.</p>\n<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><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>\n<p><strong>Example request body:</strong></p>\n<pre><code class=\"hljs language-json\"><span class=\"hljs-punctuation\">{</span>\n  <span class=\"hljs-attr\">\"repository_ids_to_add\"</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-number\">123</span><span class=\"hljs-punctuation\">,</span> <span class=\"hljs-number\">456</span><span class=\"hljs-punctuation\">]</span><span class=\"hljs-punctuation\">,</span>\n  <span class=\"hljs-attr\">\"repository_ids_to_remove\"</span><span class=\"hljs-punctuation\">:</span> <span class=\"hljs-punctuation\">[</span><span class=\"hljs-number\">789</span><span class=\"hljs-punctuation\">]</span>\n<span class=\"hljs-punctuation\">}</span>\n</code></pre>",
         "statusCodes": [
           {
             "httpStatusCode": "204",
@@ -251176,7 +251176,7 @@
           }
         ],
         "previews": [],
-        "descriptionHTML": "<div class=\"ghd-alert ghd-alert-accent\" data-container=\"alert\"><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.\nSets the default level of repository access Dependabot will have while performing an update.  Available values are:</p>\n</div>\n<ul>\n<li>'public' - Dependabot will only have access to public repositories, unless access is explicitly granted to non-public repositories.</li>\n<li>'internal' - Dependabot will only have access to public and internal repositories, unless access is explicitly granted to private repositories.</li>\n</ul>\n<p>Unauthorized users will not see the existence of this endpoint.</p>",
+        "descriptionHTML": "<p>Sets the default level of repository access Dependabot will have while performing an update.  Available values are:</p>\n<ul>\n<li>'public' - Dependabot will only have access to public repositories, unless access is explicitly granted to non-public repositories.</li>\n<li>'internal' - Dependabot will only have access to public and internal repositories, unless access is explicitly granted to private repositories.</li>\n</ul>\n<p>Unauthorized users will not see the existence of this endpoint.</p>\n<p>This operation supports both server-to-server and user-to-server access.</p>",
         "statusCodes": [
           {
             "httpStatusCode": "204",
diff --git a/src/rest/data/ghec-2022-11-28/schema.json b/src/rest/data/ghec-2022-11-28/schema.json
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.14-2022-11-28/schema.json b/src/rest/data/ghes-3.14-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/lib/config.json b/src/rest/lib/config.json
diff --git a/src/webhooks/lib/config.json b/src/webhooks/lib/config.json
