Update OpenAPI Description (#55882)

Co-authored-by: Felicity Chapman <[email protected]>

Author: docs-bot

content/rest/dependabot/index.md

@@ -1,7 +1,8 @@
 ---
-title: REST API endpoints for {% data variables.product.prodname_dependabot %}
+title: 'REST API endpoints for {% data variables.product.prodname_dependabot %}'
 shortTitle: Dependabot
-intro: 'Use the REST API to interact with {% data variables.product.prodname_dependabot %} alerts and secrets for an organization or repository.'
+intro: >-
+  Use the REST API to interact with {% data variables.product.prodname_dependabot_alerts %} and secrets for an organization or repository.
 allowTitleToDifferFromFilename: true
 versions:
   fpt: '*'
@@ -11,6 +12,7 @@ topics:
   - API
 children:
   - /alerts
+  - /repository-access
   - /secrets
 redirect_from:
   - /rest/reference/dependabot

content/rest/dependabot/repository-access.md

@@ -0,0 +1,18 @@
+---
+title: 'REST API endpoints for {% data variables.product.prodname_dependabot %} repository access'
+shortTitle: Repository access
+intro: 'Use the REST API to manage which repositories {% data variables.product.prodname_dependabot %} can access within an organization.'
+versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
+  fpt: '*'
+  ghec: '*'
+topics:
+  - API
+autogenerated: rest
+allowTitleToDifferFromFilename: true
+---
+
+## About {% data variables.product.prodname_dependabot %} repository access
+
+You can list repositories that {% data variables.product.prodname_dependabot %} already has access to and set a default repository access level for {% data variables.product.prodname_dependabot %}.
+
+<!-- Content after this section is automatically generated -->

src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json

@@ -90,6 +90,24 @@
     "title": "Administration",
     "displayTitle": "Organization permissions for \"Administration\"",
     "permissions": [
+      {
+        "category": "dependabot",
+        "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "subcategory": "repository-access",
+        "verb": "get",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "dependabot",
+        "slug": "set-the-default-repository-access-level-for-dependabot",
+        "subcategory": "repository-access",
+        "verb": "put",
+        "requestPath": "/organizations/{org}/dependabot/repository-access/default-level",
+        "additional-permissions": false,
+        "access": "write"
+      },
       {
         "category": "billing",
         "slug": "get-billing-usage-report-for-an-organization",

src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json

@@ -2186,6 +2186,18 @@
     }
   ],
   "dependabot": [
+    {
+      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "get",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
+    {
+      "slug": "set-the-default-repository-access-level-for-dependabot",
+      "subcategory": "repository-access",
+      "verb": "put",
+      "requestPath": "/organizations/{org}/dependabot/repository-access/default-level"
+    },
     {
       "slug": "list-dependabot-alerts-for-an-organization",
       "subcategory": "alerts",

src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json

@@ -108,6 +108,28 @@
     "title": "Administration",
     "displayTitle": "Organization permissions for \"Administration\"",
     "permissions": [
+      {
+        "category": "dependabot",
+        "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "subcategory": "repository-access",
+        "verb": "get",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "access": "read",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": false
+      },
+      {
+        "category": "dependabot",
+        "slug": "set-the-default-repository-access-level-for-dependabot",
+        "subcategory": "repository-access",
+        "verb": "put",
+        "requestPath": "/organizations/{org}/dependabot/repository-access/default-level",
+        "access": "write",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": false
+      },
       {
         "category": "billing",
         "slug": "get-billing-usage-report-for-an-organization",

src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json

@@ -1914,6 +1914,18 @@
     }
   ],
   "dependabot": [
+    {
+      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "get",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
+    {
+      "slug": "set-the-default-repository-access-level-for-dependabot",
+      "subcategory": "repository-access",
+      "verb": "put",
+      "requestPath": "/organizations/{org}/dependabot/repository-access/default-level"
+    },
     {
       "slug": "list-dependabot-alerts-for-an-organization",
       "subcategory": "alerts",

src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json

@@ -2186,6 +2186,18 @@
     }
   ],
   "dependabot": [
+    {
+      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "get",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
+    {
+      "slug": "set-the-default-repository-access-level-for-dependabot",
+      "subcategory": "repository-access",
+      "verb": "put",
+      "requestPath": "/organizations/{org}/dependabot/repository-access/default-level"
+    },
     {
       "slug": "list-dependabot-alerts-for-an-organization",
       "subcategory": "alerts",

src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json

@@ -282,6 +282,24 @@
         "additional-permissions": true,
         "access": "read"
       },
+      {
+        "category": "dependabot",
+        "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "subcategory": "repository-access",
+        "verb": "get",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "dependabot",
+        "slug": "set-the-default-repository-access-level-for-dependabot",
+        "subcategory": "repository-access",
+        "verb": "put",
+        "requestPath": "/organizations/{org}/dependabot/repository-access/default-level",
+        "additional-permissions": false,
+        "access": "write"
+      },
       {
         "category": "billing",
         "slug": "get-billing-usage-report-for-an-organization",

src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json

@@ -2224,6 +2224,18 @@
     }
   ],
   "dependabot": [
+    {
+      "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+      "subcategory": "repository-access",
+      "verb": "get",
+      "requestPath": "/organizations/{org}/dependabot/repository-access"
+    },
+    {
+      "slug": "set-the-default-repository-access-level-for-dependabot",
+      "subcategory": "repository-access",
+      "verb": "put",
+      "requestPath": "/organizations/{org}/dependabot/repository-access/default-level"
+    },
     {
       "slug": "list-dependabot-alerts-for-an-organization",
       "subcategory": "alerts",

src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json

@@ -340,6 +340,28 @@
         "server-to-server": true,
         "additional-permissions": true
       },
+      {
+        "category": "dependabot",
+        "slug": "lists-repositories-that-organization-admins-have-allowed-dependabot-to-access-when-updating-dependencies",
+        "subcategory": "repository-access",
+        "verb": "get",
+        "requestPath": "/organizations/{org}/dependabot/repository-access",
+        "access": "read",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": false
+      },
+      {
+        "category": "dependabot",
+        "slug": "set-the-default-repository-access-level-for-dependabot",
+        "subcategory": "repository-access",
+        "verb": "put",
+        "requestPath": "/organizations/{org}/dependabot/repository-access/default-level",
+        "access": "write",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": false
+      },
       {
         "category": "billing",
         "slug": "get-billing-usage-report-for-an-organization",