collaborators
Overview
Name | collaborators |
Type | Resource |
Id | github.repos.collaborators |
Fields
Name | Datatype |
---|---|
id | integer |
name | string |
email | string |
html_url | string |
login | string |
avatar_url | string |
type | string |
subscriptions_url | string |
gists_url | string |
followers_url | string |
organizations_url | string |
gravatar_id | string |
events_url | string |
permissions | object |
site_admin | boolean |
repos_url | string |
following_url | string |
role_name | string |
url | string |
starred_url | string |
node_id | string |
received_events_url | string |
Methods
Name | Accessible by | Required Params | Description |
---|---|---|---|
list_collaborators | SELECT | owner, repo | For organization-owned repositories, the list of collaborators includes outside collaborators, organization members that are direct collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners. Team members will include the members of child teams. You must authenticate using an access token with the read:org and repo scopes with push access to use thisendpoint. GitHub Apps must have the members organization permission and metadata repository permission to use thisendpoint. |
add_collaborator | INSERT | owner, repo, username | This endpoint triggers notifications. Creating content too quickly using this endpoint may result in secondary rate limiting. See "Secondary rate limits" and "Dealing with secondary rate limits" for details. For more information on permission levels, see "Repository permission levels for an organization". There are restrictions on which permissions can be granted to organization members when an organization base role is in place. In this case, the permission being given must be equal to or higher than the org base permission. Otherwise, the request will fail with: <br />Cannot assign {member} permission of {role name}<br /> Note that, if you choose not to pass any parameters, you'll need to set Content-Length to zero when calling out to this endpoint. For more information, see "HTTP verbs."The invitee will receive a notification that they have been invited to the repository, which they must accept or decline. They may do this via the notifications page, the email they receive, or by using the repository invitations API endpoints. Rate limits You are limited to sending 50 invitations to a repository per 24 hour period. Note there is no limit if you are inviting organization members to an organization repository. |
remove_collaborator | DELETE | owner, repo, username | |
check_collaborator | EXEC | owner, repo, username | For organization-owned repositories, the list of collaborators includes outside collaborators, organization members that are direct collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners. Team members will include the members of child teams. You must authenticate using an access token with the read:org and repo scopes with push access to use thisendpoint. GitHub Apps must have the members organization permission and metadata repository permission to use thisendpoint. |