Update OpenAPI Descriptions

Author: github-openapi-bot

lib/rest/static/apps/enabled-for-apps.json

@@ -2670,11 +2670,6 @@
       }
     ],
     "teams": [
-      {
-        "slug": "list-a-connection-between-an-external-group-and-a-team",
-        "verb": "get",
-        "requestPath": "/organizations/{org}/team/{team_slug}/external-groups"
-      },
       {
         "slug": "get-an-external-group",
         "verb": "get",
@@ -2765,6 +2760,11 @@
         "verb": "delete",
         "requestPath": "/orgs/{org}/teams/{team_slug}/discussions/{discussion_number}/comments/{comment_number}"
       },
+      {
+        "slug": "list-a-connection-between-an-external-group-and-a-team",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/teams/{team_slug}/external-groups"
+      },
       {
         "slug": "list-pending-team-invitations",
         "verb": "get",

lib/rest/static/decorated/api.github.com.json

@@ -85696,7 +85696,7 @@
     "external-groups": [
       {
         "verb": "get",
-        "requestPath": "/organizations/{org}/team/{team_slug}/external-groups",
+        "requestPath": "/orgs/{org}/external-group/{group_id}",
         "parameters": [
           {
             "name": "org",
@@ -85708,50 +85708,50 @@
             "descriptionHTML": ""
           },
           {
-            "name": "team_slug",
-            "description": "team_slug parameter",
+            "name": "group_id",
+            "description": "group_id parameter",
             "in": "path",
             "required": true,
             "schema": {
-              "type": "string"
+              "type": "integer"
             },
-            "descriptionHTML": "<p>team_slug parameter</p>"
+            "descriptionHTML": "<p>group_id parameter</p>"
           }
         ],
         "x-codeSamples": [
           {
             "lang": "Shell",
-            "source": "curl \\\n  -H \"Accept: application/vnd.github.v3+json\" \\\n  https://api.github.com/organizations/ORG/team/TEAM_SLUG/external-groups"
+            "source": "curl \\\n  -H \"Accept: application/vnd.github.v3+json\" \\\n  https://api.github.com/orgs/ORG/external-group/42"
           },
           {
             "lang": "JavaScript",
-            "source": "await octokit.request('GET /organizations/{org}/team/{team_slug}/external-groups', {\n  org: 'org',\n  team_slug: 'team_slug'\n})"
+            "source": "await octokit.request('GET /orgs/{org}/external-group/{group_id}', {\n  org: 'org',\n  group_id: 42\n})"
           }
         ],
-        "summary": "List a connection between an external group and a team",
+        "summary": "Get an external group",
         "x-github": {
           "enabledForGitHubApps": true,
           "category": "teams",
           "subcategory": "external-groups"
         },
-        "slug": "list-a-connection-between-an-external-group-and-a-team",
+        "slug": "get-an-external-group",
         "category": "teams",
         "subcategory": "external-groups",
         "notes": [],
         "bodyParameters": [],
-        "descriptionHTML": "<p>Lists a connection between a team and an external group.</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>",
+        "descriptionHTML": "<p>Displays information about the specific group's usage.  Provides a list of the group's external members as well as a list of teams that this group is connected to.</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>",
         "responses": [
           {
             "httpStatusCode": "200",
             "httpStatusMessage": "OK",
             "description": "<p>Response</p>",
-            "payload": "{\n  \"groups\": [\n    {\n      \"group_id\": \"123\",\n      \"group_name\": \"Octocat admins\",\n      \"updated_at\": \"2021-01-24T11:31:04-06:00\"\n    },\n    {\n      \"group_id\": \"456\",\n      \"group_name\": \"Octocat docs members\",\n      \"updated_at\": \"2021-03-24T11:31:04-06:00\"\n    }\n  ]\n}"
+            "payload": "{\n  \"group_id\": \"123\",\n  \"group_name\": \"Octocat admins\",\n  \"updated_at\": \"2021-01-24T11:31:04-06:00\",\n  \"teams\": [\n    {\n      \"team_id\": 1,\n      \"team_name\": \"team-test\"\n    },\n    {\n      \"team_id\": 2,\n      \"team_name\": \"team-test2\"\n    }\n  ],\n  \"members\": [\n    {\n      \"member_id\": 1,\n      \"member_login\": \"mona-lisa_eocsaxrs\",\n      \"member_name\": \"Mona Lisa\",\n      \"member_email\": \"[email protected]\"\n    },\n    {\n      \"member_id\": 2,\n      \"member_login\": \"octo-lisa_eocsaxrs\",\n      \"member_name\": \"Octo Lisa\",\n      \"member_email\": \"[email protected]\"\n    }\n  ]\n}"
           }
         ]
       },
       {
         "verb": "get",
-        "requestPath": "/orgs/{org}/external-group/{group_id}",
+        "requestPath": "/orgs/{org}/external-groups",
         "parameters": [
           {
             "name": "org",
@@ -85763,50 +85763,68 @@
             "descriptionHTML": ""
           },
           {
-            "name": "group_id",
-            "description": "group_id parameter",
-            "in": "path",
-            "required": true,
+            "name": "per_page",
+            "description": "Results per page (max 100)",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 30
+            },
+            "descriptionHTML": "<p>Results per page (max 100)</p>"
+          },
+          {
+            "name": "page",
+            "description": "Page token",
+            "in": "query",
             "schema": {
               "type": "integer"
             },
-            "descriptionHTML": "<p>group_id parameter</p>"
+            "descriptionHTML": "<p>Page token</p>"
+          },
+          {
+            "name": "display_name",
+            "description": "Limits the list to groups containing the text in the group name",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "descriptionHTML": "<p>Limits the list to groups containing the text in the group name</p>"
           }
         ],
         "x-codeSamples": [
           {
             "lang": "Shell",
-            "source": "curl \\\n  -H \"Accept: application/vnd.github.v3+json\" \\\n  https://api.github.com/orgs/ORG/external-group/42"
+            "source": "curl \\\n  -H \"Accept: application/vnd.github.v3+json\" \\\n  https://api.github.com/orgs/ORG/external-groups"
           },
           {
             "lang": "JavaScript",
-            "source": "await octokit.request('GET /orgs/{org}/external-group/{group_id}', {\n  org: 'org',\n  group_id: 42\n})"
+            "source": "await octokit.request('GET /orgs/{org}/external-groups', {\n  org: 'org'\n})"
           }
         ],
-        "summary": "Get an external group",
+        "summary": "List external groups in an organization",
         "x-github": {
           "enabledForGitHubApps": true,
           "category": "teams",
           "subcategory": "external-groups"
         },
-        "slug": "get-an-external-group",
+        "slug": "list-external-groups-in-an-organization",
         "category": "teams",
         "subcategory": "external-groups",
         "notes": [],
         "bodyParameters": [],
-        "descriptionHTML": "<p>Displays information about the specific group's usage.  Provides a list of the group's external members as well as a list of teams that this group is connected to.</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>",
+        "descriptionHTML": "<p>Lists external groups available in an organization. You can query the groups using the <code>display_name</code> parameter, only groups with a <code>group_name</code> containing the text provided in the <code>display_name</code> parameter will be returned.  You can also limit your page results using the <code>per_page</code> parameter. GitHub generates a url-encoded <code>page</code> token using a cursor value for where the next page begins. For more information on cursor pagination, see \"<a href=\"https://dev.to/jackmarchant/offset-and-cursor-pagination-explained-b89\">Offset and Cursor Pagination explained</a>.\"</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>",
         "responses": [
           {
             "httpStatusCode": "200",
             "httpStatusMessage": "OK",
             "description": "<p>Response</p>",
-            "payload": "{\n  \"group_id\": \"123\",\n  \"group_name\": \"Octocat admins\",\n  \"updated_at\": \"2021-01-24T11:31:04-06:00\",\n  \"teams\": [\n    {\n      \"team_id\": 1,\n      \"team_name\": \"team-test\"\n    },\n    {\n      \"team_id\": 2,\n      \"team_name\": \"team-test2\"\n    }\n  ],\n  \"members\": [\n    {\n      \"member_id\": 1,\n      \"member_login\": \"mona-lisa_eocsaxrs\",\n      \"member_name\": \"Mona Lisa\",\n      \"member_email\": \"[email protected]\"\n    },\n    {\n      \"member_id\": 2,\n      \"member_login\": \"octo-lisa_eocsaxrs\",\n      \"member_name\": \"Octo Lisa\",\n      \"member_email\": \"[email protected]\"\n    }\n  ]\n}"
+            "payload": "{\n  \"groups\": [\n    {\n      \"group_id\": \"123\",\n      \"group_name\": \"Octocat admins\",\n      \"updated_at\": \"2021-01-24T11:31:04-06:00\"\n    },\n    {\n      \"group_id\": \"456\",\n      \"group_name\": \"Octocat docs members\",\n      \"updated_at\": \"2021-03-24T11:31:04-06:00\"\n    }\n  ]\n}"
           }
         ]
       },
       {
         "verb": "get",
-        "requestPath": "/orgs/{org}/external-groups",
+        "requestPath": "/orgs/{org}/teams/{team_slug}/external-groups",
         "parameters": [
           {
             "name": "org",
@@ -85818,56 +85836,38 @@
             "descriptionHTML": ""
           },
           {
-            "name": "per_page",
-            "description": "Results per page (max 100)",
-            "in": "query",
-            "schema": {
-              "type": "integer",
-              "default": 30
-            },
-            "descriptionHTML": "<p>Results per page (max 100)</p>"
-          },
-          {
-            "name": "page",
-            "description": "Page token",
-            "in": "query",
-            "schema": {
-              "type": "integer"
-            },
-            "descriptionHTML": "<p>Page token</p>"
-          },
-          {
-            "name": "display_name",
-            "description": "Limits the list to groups containing the text in the group name",
-            "in": "query",
+            "name": "team_slug",
+            "description": "team_slug parameter",
+            "in": "path",
+            "required": true,
             "schema": {
               "type": "string"
             },
-            "descriptionHTML": "<p>Limits the list to groups containing the text in the group name</p>"
+            "descriptionHTML": "<p>team_slug parameter</p>"
           }
         ],
         "x-codeSamples": [
           {
             "lang": "Shell",
-            "source": "curl \\\n  -H \"Accept: application/vnd.github.v3+json\" \\\n  https://api.github.com/orgs/ORG/external-groups"
+            "source": "curl \\\n  -H \"Accept: application/vnd.github.v3+json\" \\\n  https://api.github.com/orgs/ORG/teams/TEAM_SLUG/external-groups"
           },
           {
             "lang": "JavaScript",
-            "source": "await octokit.request('GET /orgs/{org}/external-groups', {\n  org: 'org'\n})"
+            "source": "await octokit.request('GET /orgs/{org}/teams/{team_slug}/external-groups', {\n  org: 'org',\n  team_slug: 'team_slug'\n})"
           }
         ],
-        "summary": "List external groups in an organization",
+        "summary": "List a connection between an external group and a team",
         "x-github": {
           "enabledForGitHubApps": true,
           "category": "teams",
           "subcategory": "external-groups"
         },
-        "slug": "list-external-groups-in-an-organization",
+        "slug": "list-a-connection-between-an-external-group-and-a-team",
         "category": "teams",
         "subcategory": "external-groups",
         "notes": [],
         "bodyParameters": [],
-        "descriptionHTML": "<p>Lists external groups available in an organization. You can query the groups using the <code>display_name</code> parameter, only groups with a <code>group_name</code> containing the text provided in the <code>display_name</code> parameter will be returned.  You can also limit your page results using the <code>per_page</code> parameter. GitHub generates a url-encoded <code>page</code> token using a cursor value for where the next page begins. For more information on cursor pagination, see \"<a href=\"https://dev.to/jackmarchant/offset-and-cursor-pagination-explained-b89\">Offset and Cursor Pagination explained</a>.\"</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>",
+        "descriptionHTML": "<p>Lists a connection between a team and an external group.</p>\n<p>You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"<a href=\"https://docs.github.com/github/getting-started-with-github/githubs-products\">GitHub's products</a>\" in the GitHub Help documentation.</p>",
         "responses": [
           {
             "httpStatusCode": "200",