Merge pull request #1539 from github/openapi-update-c1ca994ec0fdcb4ff9853c6b8b1a2959e0918a0e4c59d869aa154294501aacc1

Update OpenAPI 3.1 Descriptions

Author: timrogers

descriptions-next/api.github.com/api.github.com.json

@@ -29188,6 +29188,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-next/api.github.com/api.github.com.yaml

@@ -21061,6 +21061,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-next/api.github.com/dereferenced/api.github.com.deref.json

@@ -257394,6 +257394,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-next/api.github.com/dereferenced/api.github.com.deref.yaml

@@ -44742,6 +44742,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
       - *30
       responses:

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

@@ -200240,6 +200240,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-next/ghes-3.2/dereferenced/ghes-3.2.deref.yaml

@@ -37383,6 +37383,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-next/ghes-3.2/ghes-3.2.json

@@ -25136,6 +25136,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-next/ghes-3.2/ghes-3.2.yaml

@@ -18300,6 +18300,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: