Merge pull request #630 from github/openapi-update-1866343e7087943544af384a11fbd158e13e13bfcb00777025d60d4935351455

Update OpenAPI Descriptions

Author: becco

descriptions/api.github.com/api.github.com.json

@@ -9199,10 +9199,11 @@
           {
             "name": "group_id",
             "description": "External Group Id",
-            "in": "query",
+            "in": "path",
             "schema": {
               "type": "integer"
-            }
+            },
+            "required": true
           }
         ],
         "responses": {
@@ -9254,7 +9255,7 @@
             "description": "Page token",
             "in": "query",
             "schema": {
-              "type": "string"
+              "type": "integer"
             }
           },
           {
@@ -12492,7 +12493,6 @@
                     "enum": [
                       "public",
                       "private",
-                      "visibility",
                       "internal"
                     ]
                   },
@@ -14268,7 +14268,7 @@
         "tags": [
           "teams"
         ],
-        "operationId": "operations/teams/link-external-idp-group-to-team-for-org",
+        "operationId": "teams/link-external-idp-group-to-team-for-org",
         "externalDocs": {
           "description": "API method documentation",
           "url": "https://docs.github.com/rest/reference/teams#link-external-idp-group-team-connection"
@@ -14334,7 +14334,7 @@
         "tags": [
           "teams"
         ],
-        "operationId": "operations/teams/unlink-external-idp-group-from-team-for-org",
+        "operationId": "teams/unlink-external-idp-group-from-team-for-org",
         "externalDocs": {
           "description": "API method documentation",
           "url": "https://docs.github.com/rest/reference/teams#unlink-external-idp-group-team-connection"
@@ -16933,7 +16933,6 @@
                     "enum": [
                       "public",
                       "private",
-                      "visibility",
                       "internal"
                     ]
                   },
@@ -22675,7 +22674,7 @@
                   },
                   "actions": {
                     "type": "array",
-                    "description": "Displays a button on GitHub that can be clicked to alert your app to do additional tasks. For example, a code linting app can display a button that automatically fixes detected errors. The button created in this object is displayed after the check run completes. When a user clicks the button, GitHub sends the [`check_run.requested_action` webhook](https://docs.github.com/webhooks/event-payloads/#check_run) to your app. Each action includes a `label`, `identifier` and `description`. A maximum of three actions are accepted. See the [`actions` object](https://docs.github.com/rest/reference/checks#actions-object) description. To learn more about check runs and requested actions, see \"[Check runs and requested actions](https://docs.github.com/rest/reference/checks#check-runs-and-requested-actions).\" To learn more about check runs and requested actions, see \"[Check runs and requested actions](https://docs.github.com/rest/reference/checks#check-runs-and-requested-actions).\"",
+                    "description": "Displays a button on GitHub that can be clicked to alert your app to do additional tasks. For example, a code linting app can display a button that automatically fixes detected errors. The button created in this object is displayed after the check run completes. When a user clicks the button, GitHub sends the [`check_run.requested_action` webhook](https://docs.github.com/webhooks/event-payloads/#check_run) to your app. Each action includes a `label`, `identifier` and `description`. A maximum of three actions are accepted. See the [`actions` object](https://docs.github.com/rest/reference/checks#actions-object) description. To learn more about check runs and requested actions, see \"[Check runs and requested actions](https://docs.github.com/rest/reference/checks#check-runs-and-requested-actions).\"",
                     "maxItems": 3,
                     "items": {
                       "type": "object",
@@ -24346,7 +24345,7 @@
     "/repos/{owner}/{repo}/collaborators": {
       "get": {
         "summary": "List repository collaborators",
-        "description": "For organization-owned repositories, the list of collaborators includes outside collaborators, organization members that are direct collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners.\n\nTeam members will include the members of child teams.",
+        "description": "For organization-owned repositories, the list of collaborators includes outside collaborators, organization members that are direct collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners.\n\nTeam members will include the members of child teams.\n\nYou must have push access to the repository in order to list collaborators.",
         "tags": [
           "repos"
         ],
@@ -49289,9 +49288,6 @@
               }
             }
           },
-          "202": {
-            "$ref": "#/components/responses/accepted"
-          },
           "404": {
             "$ref": "#/components/responses/not_found"
           }
@@ -64639,7 +64635,16 @@
                 "default": {
                   "type": "boolean"
                 }
-              }
+              },
+              "required": [
+                "id",
+                "node_id",
+                "url",
+                "name",
+                "description",
+                "color",
+                "default"
+              ]
             }
           },
           "milestone": {
@@ -70105,7 +70110,16 @@
                 "default": {
                   "type": "boolean"
                 }
-              }
+              },
+              "required": [
+                "id",
+                "node_id",
+                "url",
+                "name",
+                "description",
+                "color",
+                "default"
+              ]
             }
           },
           "milestone": {

descriptions/api.github.com/api.github.com.yaml

@@ -6649,9 +6649,10 @@ paths:
       - "$ref": "#/components/parameters/org"
       - name: group_id
         description: External Group Id
-        in: query
+        in: path
         schema:
           type: integer
+        required: true
       responses:
         '200':
           description: Response
@@ -6687,7 +6688,7 @@ paths:
         description: Page token
         in: query
         schema:
-          type: string
+          type: integer
       - name: display_name
         description: Limits the list to groups containing the text in the group name
         in: query
@@ -8962,7 +8963,6 @@ paths:
                   enum:
                   - public
                   - private
-                  - visibility
                   - internal
                 has_issues:
                   type: boolean
@@ -10240,7 +10240,7 @@ paths:
         You can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see "[GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products)" in the GitHub Help documentation.
       tags:
       - teams
-      operationId: operations/teams/link-external-idp-group-to-team-for-org
+      operationId: teams/link-external-idp-group-to-team-for-org
       externalDocs:
         description: API method documentation
         url: https://docs.github.com/rest/reference/teams#link-external-idp-group-team-connection
@@ -10285,7 +10285,7 @@ paths:
         You can manage team membership with your IdP using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products) in the GitHub Help documentation.
       tags:
       - teams
-      operationId: operations/teams/unlink-external-idp-group-from-team-for-org
+      operationId: teams/unlink-external-idp-group-from-team-for-org
       externalDocs:
         description: API method documentation
         url: https://docs.github.com/rest/reference/teams#unlink-external-idp-group-team-connection
@@ -12110,7 +12110,6 @@ paths:
                   enum:
                   - public
                   - private
-                  - visibility
                   - internal
                 security_and_analysis:
                   type: object
@@ -16241,8 +16240,6 @@ paths:
                     [`actions` object](https://docs.github.com/rest/reference/checks#actions-object)
                     description. To learn more about check runs and requested actions,
                     see "[Check runs and requested actions](https://docs.github.com/rest/reference/checks#check-runs-and-requested-actions)."
-                    To learn more about check runs and requested actions, see "[Check
-                    runs and requested actions](https://docs.github.com/rest/reference/checks#check-runs-and-requested-actions)."
                   maxItems: 3
                   items:
                     type: object
@@ -17553,6 +17550,8 @@ paths:
         For organization-owned repositories, the list of collaborators includes outside collaborators, organization members that are direct collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners.
 
         Team members will include the members of child teams.
+
+        You must have push access to the repository in order to list collaborators.
       tags:
       - repos
       operationId: repos/list-collaborators
@@ -35463,8 +35462,6 @@ paths:
                   "$ref": "#/components/examples/public-user-default-response"
                 response-with-git-hub-plan-information:
                   "$ref": "#/components/examples/public-user-response-with-git-hub-plan-information"
-        '202':
-          "$ref": "#/components/responses/accepted"
         '404':
           "$ref": "#/components/responses/not_found"
       x-github:
@@ -47185,6 +47182,14 @@ components:
                 type: string
               default:
                 type: boolean
+            required:
+            - id
+            - node_id
+            - url
+            - name
+            - description
+            - color
+            - default
         milestone:
           "$ref": "#/components/schemas/nullable-milestone"
         active_lock_reason:
@@ -51266,6 +51271,14 @@ components:
                 type: string
               default:
                 type: boolean
+            required:
+            - id
+            - node_id
+            - url
+            - name
+            - description
+            - color
+            - default
         milestone:
           "$ref": "#/components/schemas/nullable-milestone"
         active_lock_reason: