fix(docs): update docs to reflect that repos.listCollaborators (`GE…

…T /repos/{owner}/{repo}/collaborators`) can now be filtered by `permission` (#489)

WIP octokit/openapi updated

docs/ghe-32.md

@@ -642,7 +642,7 @@ octokit.repos.getWebhookConfigForRepo({owner, repo, hook_id});
 octokit.repos.getWebhookDelivery({owner, repo, hook_id, delivery_id});
 octokit.repos.listBranches({owner, repo, protected, per_page, page});
 octokit.repos.listBranchesForHeadCommit({owner, repo, commit_sha});
-octokit.repos.listCollaborators({owner, repo, affiliation, per_page, page});
+octokit.repos.listCollaborators({owner, repo, affiliation, permission, per_page, page});
 octokit.repos.listCommentsForCommit({owner, repo, commit_sha, per_page, page});
 octokit.repos.listCommitCommentsForRepo({owner, repo, per_page, page});
 octokit.repos.listCommitStatusesForRef({owner, repo, ref, per_page, page});

docs/ghe-33.md

@@ -650,7 +650,7 @@ octokit.repos.getWebhookDelivery({owner, repo, hook_id, delivery_id});
 octokit.repos.listAutolinks({owner, repo, page});
 octokit.repos.listBranches({owner, repo, protected, per_page, page});
 octokit.repos.listBranchesForHeadCommit({owner, repo, commit_sha});
-octokit.repos.listCollaborators({owner, repo, affiliation, per_page, page});
+octokit.repos.listCollaborators({owner, repo, affiliation, permission, per_page, page});
 octokit.repos.listCommentsForCommit({owner, repo, commit_sha, per_page, page});
 octokit.repos.listCommitCommentsForRepo({owner, repo, per_page, page});
 octokit.repos.listCommitStatusesForRef({owner, repo, ref, per_page, page});

docs/ghe-34.md

@@ -709,7 +709,7 @@ octokit.repos.listAutolinks({owner, repo, page});
 octokit.repos.listBranches({owner, repo, protected, per_page, page});
 octokit.repos.listBranchesForHeadCommit({owner, repo, commit_sha});
 octokit.repos.listCacheInfo({owner, repo, per_page, page});
-octokit.repos.listCollaborators({owner, repo, affiliation, per_page, page});
+octokit.repos.listCollaborators({owner, repo, affiliation, permission, per_page, page});
 octokit.repos.listCommentsForCommit({owner, repo, commit_sha, per_page, page});
 octokit.repos.listCommitCommentsForRepo({owner, repo, per_page, page});
 octokit.repos.listCommitStatusesForRef({owner, repo, ref, per_page, page});

docs/ghe-35.md

@@ -730,7 +730,7 @@ octokit.repos.listAutolinks({owner, repo, page});
 octokit.repos.listBranches({owner, repo, protected, per_page, page});
 octokit.repos.listBranchesForHeadCommit({owner, repo, commit_sha});
 octokit.repos.listCacheInfo({owner, repo, per_page, page});
-octokit.repos.listCollaborators({owner, repo, affiliation, per_page, page});
+octokit.repos.listCollaborators({owner, repo, affiliation, permission, per_page, page});
 octokit.repos.listCommentsForCommit({owner, repo, commit_sha, per_page, page});
 octokit.repos.listCommitCommentsForRepo({owner, repo, per_page, page});
 octokit.repos.listCommitStatusesForRef({owner, repo, ref, per_page, page});

docs/ghe-36.md

@@ -735,7 +735,7 @@ octokit.repos.listAutolinks({owner, repo, page});
 octokit.repos.listBranches({owner, repo, protected, per_page, page});
 octokit.repos.listBranchesForHeadCommit({owner, repo, commit_sha});
 octokit.repos.listCacheInfo({owner, repo, per_page, page});
-octokit.repos.listCollaborators({owner, repo, affiliation, per_page, page});
+octokit.repos.listCollaborators({owner, repo, affiliation, permission, per_page, page});
 octokit.repos.listCommentsForCommit({owner, repo, commit_sha, per_page, page});
 octokit.repos.listCommitCommentsForRepo({owner, repo, per_page, page});
 octokit.repos.listCommitStatusesForRef({owner, repo, ref, per_page, page});

scripts/update-endpoints/generated/ghe32-endpoints.json

@@ -34341,7 +34341,7 @@
     "url": "/repos/{owner}/{repo}/contents/{path}",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "Creates a new file or replaces an existing file in a repository.",
+    "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/reference/repos#create-or-update-file-contents",
     "previews": [],
     "headers": [],
@@ -39421,6 +39421,19 @@
         "alias": null,
         "deprecated": null
       },
+      {
+        "name": "permission",
+        "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
+        "in": "QUERY",
+        "type": "string",
+        "required": false,
+        "enum": ["pull", "triage", "push", "maintain", "admin"],
+        "allowNull": false,
+        "mapToData": null,
+        "validation": null,
+        "alias": null,
+        "deprecated": null
+      },
       {
         "name": "per_page",
         "description": "The number of results per page (max 100).",
@@ -41673,7 +41686,7 @@
     "url": "/repos/{owner}/{repo}/hooks",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "",
+    "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/webhooks/repos#list-repository-webhooks",
     "previews": [],
     "headers": [],

scripts/update-endpoints/generated/ghe33-endpoints.json

@@ -34518,7 +34518,7 @@
     "url": "/repos/{owner}/{repo}/contents/{path}",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "Creates a new file or replaces an existing file in a repository.",
+    "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/reference/repos#create-or-update-file-contents",
     "previews": [],
     "headers": [],
@@ -39998,6 +39998,19 @@
         "alias": null,
         "deprecated": null
       },
+      {
+        "name": "permission",
+        "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
+        "in": "QUERY",
+        "type": "string",
+        "required": false,
+        "enum": ["pull", "triage", "push", "maintain", "admin"],
+        "allowNull": false,
+        "mapToData": null,
+        "validation": null,
+        "alias": null,
+        "deprecated": null
+      },
       {
         "name": "per_page",
         "description": "The number of results per page (max 100).",
@@ -42250,7 +42263,7 @@
     "url": "/repos/{owner}/{repo}/hooks",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "",
+    "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/webhooks/repos#list-repository-webhooks",
     "previews": [],
     "headers": [],

scripts/update-endpoints/generated/ghe34-endpoints.json

@@ -36912,7 +36912,7 @@
     "url": "/repos/{owner}/{repo}/contents/{path}",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "Creates a new file or replaces an existing file in a repository.",
+    "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/reference/repos#create-or-update-file-contents",
     "previews": [],
     "headers": [],
@@ -42473,6 +42473,19 @@
         "alias": null,
         "deprecated": null
       },
+      {
+        "name": "permission",
+        "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
+        "in": "QUERY",
+        "type": "string",
+        "required": false,
+        "enum": ["pull", "triage", "push", "maintain", "admin"],
+        "allowNull": false,
+        "mapToData": null,
+        "validation": null,
+        "alias": null,
+        "deprecated": null
+      },
       {
         "name": "per_page",
         "description": "The number of results per page (max 100).",
@@ -44725,7 +44738,7 @@
     "url": "/repos/{owner}/{repo}/hooks",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "",
+    "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/webhooks/repos#list-repository-webhooks",
     "previews": [],
     "headers": [],

scripts/update-endpoints/generated/ghe35-endpoints.json

@@ -38129,7 +38129,7 @@
     "url": "/repos/{owner}/{repo}/contents/{path}",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "Creates a new file or replaces an existing file in a repository.",
+    "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/reference/repos#create-or-update-file-contents",
     "previews": [],
     "headers": [],
@@ -43814,6 +43814,19 @@
         "alias": null,
         "deprecated": null
       },
+      {
+        "name": "permission",
+        "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
+        "in": "QUERY",
+        "type": "string",
+        "required": false,
+        "enum": ["pull", "triage", "push", "maintain", "admin"],
+        "allowNull": false,
+        "mapToData": null,
+        "validation": null,
+        "alias": null,
+        "deprecated": null
+      },
       {
         "name": "per_page",
         "description": "The number of results per page (max 100).",
@@ -46117,7 +46130,7 @@
     "url": "/repos/{owner}/{repo}/hooks",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "",
+    "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/webhooks/repos#list-repository-webhooks",
     "previews": [],
     "headers": [],

scripts/update-endpoints/generated/ghe36-endpoints.json

@@ -38502,7 +38502,7 @@
     "url": "/repos/{owner}/{repo}/contents/{path}",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "Creates a new file or replaces an existing file in a repository.",
+    "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/reference/repos#create-or-update-file-contents",
     "previews": [],
     "headers": [],
@@ -44187,6 +44187,19 @@
         "alias": null,
         "deprecated": null
       },
+      {
+        "name": "permission",
+        "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
+        "in": "QUERY",
+        "type": "string",
+        "required": false,
+        "enum": ["pull", "triage", "push", "maintain", "admin"],
+        "allowNull": false,
+        "mapToData": null,
+        "validation": null,
+        "alias": null,
+        "deprecated": null
+      },
       {
         "name": "per_page",
         "description": "The number of results per page (max 100).",
@@ -46490,7 +46503,7 @@
     "url": "/repos/{owner}/{repo}/hooks",
     "isDeprecated": false,
     "deprecationDate": null,
-    "description": "",
+    "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
     "documentationUrl": "https://docs.github.com/[email protected]/rest/webhooks/repos#list-repository-webhooks",
     "previews": [],
     "headers": [],