Update OpenAPI Description (github#36319)

Co-authored-by: Sarita Iyer <66540150+saritai@users.noreply.github.com>

content/rest/dependency-graph/index.md

@@ -1,6 +1,8 @@
 ---
 title: Dependency Graph
-intro: Use the REST API to view dependency changes and their security impact on your repository.
+intro: >-
+  Use the REST API to view dependency changes and their security impact on your
+  repository.
 versions:
   fpt: '*'
   ghes: '>=3.6'
@@ -10,6 +12,7 @@ topics:
 children:
   - /dependency-review
   - /dependency-submission
+  - /sboms
 redirect_from:
   - /rest/reference/dependency-graph
 autogenerated: rest

content/rest/dependency-graph/sboms.md

@@ -0,0 +1,14 @@
+---
+title: Software bill of materials (SBOM)
+shortTitle: Software bill of materials (SBOM)
+intro: 'Use the REST API to export the software bill of materials (SBOM) for a repository.'
+versions:
+  fpt: '*'
+  ghec: '*'
+topics:
+  - API
+autogenerated: rest
+allowTitleToDifferFromFilename: true
+---
+
+<!-- Content after this section is automatically generated -->

content/rest/orgs/index.md

@@ -1,6 +1,8 @@
 ---
 title: Organizations
-intro: 'Use the REST API to control and manage all your {% data variables.product.product_name %} organizations.'
+intro: >-
+  Use the REST API to control and manage all your {% data
+  variables.product.product_name %} organizations.
 allowTitleToDifferFromFilename: true
 redirect_from:
   - /v3/orgs
@@ -18,6 +20,7 @@ children:
   - /custom-roles
   - /members
   - /outside-collaborators
+  - /personal-access-tokens
   - /security-managers
   - /webhooks
 autogenerated: rest

content/rest/orgs/personal-access-tokens.md

@@ -0,0 +1,20 @@
+---
+title: Personal access tokens
+shortTitle: Personal access tokens
+intro: 'Use the REST API to manage {% data variables.product.pat_v2 %}s.'
+versions:
+  fpt: '*'
+  ghec: '*'
+topics:
+  - API
+autogenerated: rest
+allowTitleToDifferFromFilename: true
+---
+
+{% note %}
+
+**Note**: {% data reusables.user-settings.pat-v2-beta %}
+
+{% endnote %}
+
+<!-- Content after this section is automatically generated -->

content/rest/users/social-accounts.md

@@ -12,3 +12,5 @@ autogenerated: rest
 ## About social account administration
 
 {% data reusables.user-settings.user-api %}
+
+<!-- Content after this section is automatically generated -->

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

@@ -2288,49 +2288,49 @@
     },
     {
       "slug": "list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "get",
       "requestPath": "/organizations/{org}/personal-access-token-requests"
     },
     {
       "slug": "review-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "post",
       "requestPath": "/organizations/{org}/personal-access-token-requests"
     },
     {
       "slug": "review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "post",
       "requestPath": "/organizations/{org}/personal-access-token-requests/{pat_request_id}"
     },
     {
       "slug": "list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "get",
       "requestPath": "/organizations/{org}/personal-access-token-requests/{pat_request_id}/repositories"
     },
     {
       "slug": "list-fine-grained-personal-access-tokens-with-access-to-organization-resources",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "get",
       "requestPath": "/organizations/{org}/personal-access-tokens"
     },
     {
       "slug": "update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "post",
       "requestPath": "/organizations/{org}/personal-access-tokens"
     },
     {
       "slug": "update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "post",
       "requestPath": "/organizations/{org}/personal-access-tokens/{pat_id}"
     },
     {
       "slug": "list-repositories-a-fine-grained-personal-access-token-has-access-to",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "get",
       "requestPath": "/organizations/{org}/personal-access-tokens/{pat_id}/repositories"
     },

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

@@ -2400,49 +2400,49 @@
     },
     {
       "slug": "list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "get",
       "requestPath": "/organizations/{org}/personal-access-token-requests"
     },
     {
       "slug": "review-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "post",
       "requestPath": "/organizations/{org}/personal-access-token-requests"
     },
     {
       "slug": "review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "post",
       "requestPath": "/organizations/{org}/personal-access-token-requests/{pat_request_id}"
     },
     {
       "slug": "list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "get",
       "requestPath": "/organizations/{org}/personal-access-token-requests/{pat_request_id}/repositories"
     },
     {
       "slug": "list-fine-grained-personal-access-tokens-with-access-to-organization-resources",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "get",
       "requestPath": "/organizations/{org}/personal-access-tokens"
     },
     {
       "slug": "update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "post",
       "requestPath": "/organizations/{org}/personal-access-tokens"
     },
     {
       "slug": "update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "post",
       "requestPath": "/organizations/{org}/personal-access-tokens/{pat_id}"
     },
     {
       "slug": "list-repositories-a-fine-grained-personal-access-token-has-access-to",
-      "subcategory": "orgs",
+      "subcategory": "personal-access-tokens",
       "verb": "get",
       "requestPath": "/organizations/{org}/personal-access-tokens/{pat_id}/repositories"
     },

src/github-apps/lib/config.json

@@ -1,3 +1,3 @@
 {
-  "sha": "e27c8f10a2208e6a8df88e64d2b40c9c7a1ecd2d"
+  "sha": "e462c64f50b84f040ac76cd2205984ddf151b67f"
 }

src/rest/data/client-side-rest-api-redirects.json

@@ -232,18 +232,10 @@
   "/rest/activity#set-a-thread-subscription": "/rest/activity/notifications#set-a-thread-subscription",
   "/rest/activity#delete-a-thread-subscription": "/rest/activity/notifications#delete-a-thread-subscription",
   "/rest/orgs#list-organizations": "/rest/orgs/orgs#list-organizations",
-  "/rest/orgs/orgs#list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens": "/rest/orgs/orgs#list-requests-to-access-organization-resources-with-fine-grained-personal-access-tokens",
-  "/rest/orgs#orgs": "/rest/orgs/orgs",
-  "/rest/orgs/orgs#review-requests-to-access-organization-resources-with-a-fine-grained-personal-access-token": "/rest/orgs/orgs#review-requests-to-access-organization-resources-with-a-fine-grained-personal-access-token",
-  "/rest/orgs/orgs#review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token": "/rest/orgs/orgs#review-a-request-to-access-organization-resources-with-a-fine-grained-personal-access-token",
-  "/rest/orgs/orgs#list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token": "/rest/orgs/orgs#list-repositories-requested-to-be-accessed-by-a-fine-grained-personal-access-token",
-  "/rest/orgs/orgs#list-fine-grained-personal-access-tokens-with-access-to-organization-resources": "/rest/orgs/orgs#list-fine-grained-personal-access-tokens-with-access-to-organization-resources",
-  "/rest/orgs/orgs#update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens": "/rest/orgs/orgs#update-the-access-to-organization-resources-via-fine-grained-personal-access-tokens",
-  "/rest/orgs/orgs#update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources": "/rest/orgs/orgs#update-the-access-a-fine-grained-personal-access-token-has-to-organization-resources",
-  "/rest/orgs/orgs#list-repositories-a-fine-grained-personal-access-token-has-access-to": "/rest/orgs/orgs#list-repositories-a-fine-grained-personal-access-token-has-access-to",
   "/rest/orgs#get-an-organization": "/rest/orgs/orgs#get-an-organization",
   "/rest/orgs#update-an-organization": "/rest/orgs/orgs#update-an-organization",
   "/rest/orgs/orgs/#delete-an-organization": "/rest/orgs/orgs#delete-an-organization",
+  "/rest/orgs#orgs": "/rest/orgs/orgs",
   "/rest/actions#get-github-actions-cache-usage-for-an-organization": "/rest/actions/cache#get-github-actions-cache-usage-for-an-organization",
   "/rest/actions#cache": "/rest/actions/cache",
   "/rest/actions#list-repositories-with-github-actions-cache-usage-for-an-organization": "/rest/actions/cache#list-repositories-with-github-actions-cache-usage-for-an-organization",
@@ -638,6 +630,8 @@
   "/rest/dependabot#delete-a-repository-secret": "/rest/dependabot/secrets#delete-a-repository-secret",
   "/rest/dependency-graph#get-a-diff-of-the-dependencies-between-commits": "/rest/dependency-graph/dependency-review#get-a-diff-of-the-dependencies-between-commits",
   "/rest/dependency-graph#dependency-review": "/rest/dependency-graph/dependency-review",
+  "/rest/dependency-graph/sboms#export-a-software-bill-of-materials-sbom-for-a-repository": "/rest/dependency-graph/sboms#export-a-software-bill-of-materials-sbom-for-a-repository",
+  "/rest/dependency-graph#sboms": "/rest/dependency-graph/sboms",
   "/rest/dependency-graph#create-a-snapshot-of-dependencies-for-a-repository": "/rest/dependency-graph/dependency-submission#create-a-snapshot-of-dependencies-for-a-repository",
   "/rest/dependency-graph#dependency-submission": "/rest/dependency-graph/dependency-submission",
   "/rest/deployments/deployments#list-deployments": "/rest/deployments/deployments#list-deployments",