Skip to content

gateixeira/manage-collaborators-action

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

Manage Collaborators Action

Check Dist/ CodeQL Publish


This GitHub action adds and removes multiple users from multiple repositories.

If a user is already part of the repository, running it again with a different permission will change the permission of the user.

A user will be removed from the repository regardless whether the user accepted the invitation. A pending invitation will be cancelled.


Inputs

NAME DESCRIPTION TYPE REQUIRED DEFAULT
token A GitHub token with admin access to the target repositories string true N/A
users Comma-separated GitHub slug of users to provide access to. string true N/A
repositories Comma-separated GitHub slug of repositories to provide access to (format /<repo_name>). string true N/A
action The action to perform. Add or Remove. string true N/A
role Role of the user in the repository. Only required if action is add. string false N/A

Usage example

Add the following snippet to an existing workflow file

- name: Run Manager Collaborators Action
  id: manager-collaborators-action
  uses: gateixeira/manage-collaborators-action@v1.0.1
  with:
    token: ${{ secrets.REPO_ACCESS_TOKEN }}
    repositories: owner/repo1,owner/repo2
    users: user1,user2
    role: push
    action: add