Skip to content

Commit a5030ea

Browse files
feat: maintain and triage user permissions in orgs (#62)
Co-authored-by: Octokit Bot <33075676+octokitbot@users.noreply.github.com>
1 parent d8b995d commit a5030ea

File tree

6 files changed

+176
-24
lines changed

6 files changed

+176
-24
lines changed

docs/repos/getCollaboratorPermissionLevel.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Review a user's permission level
22

3-
Possible values for the `permission` key: `admin`, `write`, `read`, `none`.
3+
Checks the repository permission of a collaborator. The possible repository permissions are `admin`, `write`, `read`, and `none`.
44

55
```js
66
octokit.repos.getCollaboratorPermissionLevel({

docs/repos/updateInvitation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ invitation_id parameter
3636
</td></tr>
3737
<tr><td>permissions</td><td>no</td><td>
3838

39-
The permissions that the associated user will have on the repository. Valid values are `read`, `write`, and `admin`.
39+
The permissions that the associated user will have on the repository. Valid values are `read`, `write`, `maintain`, `triage`, and `admin`.
4040

4141
</td></tr>
4242
</tbody>

docs/teams/addOrUpdateRepoInOrg.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ To add a repository to a team or update the team's permission on a repository, t
44

55
**Note:** You can also specify a team by `org_id` and `team_id` using the route `PUT /organizations/:org_id/team/:team_id/repos/:owner/:repo`.
66

7+
For more information about the permission levels, see "[Repository permission levels for an organization](https://help.github.com/en/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization)" in the GitHub Help documentation.
8+
79
```js
810
octokit.teams.addOrUpdateRepoInOrg({
911
org,
@@ -49,7 +51,9 @@ repo parameter
4951
The permission to grant the team on this repository. Can be one of:
5052
\* `pull` - team members can pull, but not push to or administer this repository.
5153
\* `push` - team members can pull and push, but not administer this repository.
52-
\* `admin` - team members can pull, push and administer this repository.
54+
\* `admin` - team members can pull, push and administer this repository.
55+
\* `maintain` - team members can manage the repository without access to sensitive or destructive actions. Recommended for project managers. Only applies to repositories owned by organizations.
56+
\* `triage` - team members can proactively manage issues and pull requests without write access. Recommended for contributors who triage a repository. Only applies to repositories owned by organizations.
5357

5458
If no permission is specified, the team's `permission` attribute will be used to determine what permission to grant the team on this repository.
5559

docs/teams/checkManagesRepoInOrg.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Check if a team manages a repository
22

3-
Checks whether a team has `admin`, `push`, or `pull` permission for a repository. Repositories inherited through a parent team will also be checked.
3+
Checks whether a team has `admin`, `push`, `maintain`, `triage`, or `pull` permission for a repository. Repositories inherited through a parent team will also be checked.
44

55
**Note:** You can also specify a team by `org_id` and `team_id` using the route `GET /organizations/:org_id/team/:team_id/repos/:owner/:repo`.
66

0 commit comments

Comments
 (0)