Merge pull request #1538 from github/openapi-update-a8e064789f49cb0732da45a840bd1234ee91154634ce8ad8a1ac36fe3a39a82c

Update OpenAPI 3.0 Descriptions

Author: timrogers

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

@@ -29038,6 +29038,22 @@
               "default": "all"
             }
           },
+          {
+            "name": "permission",
+            "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "pull",
+                "triage",
+                "push",
+                "maintain",
+                "admin"
+              ]
+            }
+          },
           {
             "$ref": "#/components/parameters/per-page"
           },

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

@@ -20989,6 +20989,19 @@ paths:
           - direct
           - all
           default: all
+      - name: permission
+        description: Filter collaborators by the permissions they have on the repository.
+          If not specified, all collaborators will be returned.
+        in: query
+        required: false
+        schema:
+          type: string
+          enum:
+          - pull
+          - triage
+          - push
+          - maintain
+          - admin
       - "$ref": "#/components/parameters/per-page"
       - "$ref": "#/components/parameters/page"
       responses:

descriptions/api.github.com/dereferenced/api.github.com.deref.json

@@ -218454,6 +218454,22 @@
               "default": "all"
             }
           },
+          {
+            "name": "permission",
+            "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "pull",
+                "triage",
+                "push",
+                "maintain",
+                "admin"
+              ]
+            }
+          },
           {
             "name": "per_page",
             "description": "The number of results per page (max 100).",

descriptions/api.github.com/dereferenced/api.github.com.deref.yaml

@@ -43526,6 +43526,19 @@ paths:
           - direct
           - all
           default: all
+      - name: permission
+        description: Filter collaborators by the permissions they have on the repository.
+          If not specified, all collaborators will be returned.
+        in: query
+        required: false
+        schema:
+          type: string
+          enum:
+          - pull
+          - triage
+          - push
+          - maintain
+          - admin
       - *12
       - *32
       responses:

descriptions/ghes-3.2/dereferenced/ghes-3.2.deref.json

@@ -170285,6 +170285,22 @@
               "default": "all"
             }
           },
+          {
+            "name": "permission",
+            "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "pull",
+                "triage",
+                "push",
+                "maintain",
+                "admin"
+              ]
+            }
+          },
           {
             "name": "per_page",
             "description": "The number of results per page (max 100).",

descriptions/ghes-3.2/dereferenced/ghes-3.2.deref.yaml

@@ -36358,6 +36358,19 @@ paths:
           - direct
           - all
           default: all
+      - name: permission
+        description: Filter collaborators by the permissions they have on the repository.
+          If not specified, all collaborators will be returned.
+        in: query
+        required: false
+        schema:
+          type: string
+          enum:
+          - pull
+          - triage
+          - push
+          - maintain
+          - admin
       - *5
       - *6
       responses:

descriptions/ghes-3.2/ghes-3.2.json

@@ -25003,6 +25003,22 @@
               "default": "all"
             }
           },
+          {
+            "name": "permission",
+            "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "pull",
+                "triage",
+                "push",
+                "maintain",
+                "admin"
+              ]
+            }
+          },
           {
             "$ref": "#/components/parameters/per-page"
           },

descriptions/ghes-3.2/ghes-3.2.yaml

@@ -18238,6 +18238,19 @@ paths:
           - direct
           - all
           default: all
+      - name: permission
+        description: Filter collaborators by the permissions they have on the repository.
+          If not specified, all collaborators will be returned.
+        in: query
+        required: false
+        schema:
+          type: string
+          enum:
+          - pull
+          - triage
+          - push
+          - maintain
+          - admin
       - "$ref": "#/components/parameters/per-page"
       - "$ref": "#/components/parameters/page"
       responses: