Add a repository collaborator

PUT

/repos/{owner}/{repo}/collaborators/{username}

This endpoint triggers notifications. Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "Rate limits for the API" and "Best practices for using the REST API."

Adding an outside collaborator may be restricted by enterprise administrators. For more information, see "Enforcing repository management policies in your enterprise."

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:

Cannot assign {member} permission of {role name}

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 method."

Updating an existing collaborator's permission level

The endpoint can also be used to change the permissions of an existing collaborator without first removing and re-adding the collaborator. To change the permissions, use the same endpoint and pass a different permission parameter. The response will be a 204, with no other indication that the permission level changed.

リクエストパラメータ

パスパラメータ

リクエストボディパラメータapplication/json

例

レスポンス

🟢204No Content

Response when:

an existing collaborator is added as a collaborator

an organization member is added as an individual collaborator

an existing team member (whose team is also a repository collaborator) is added as an individual collaborator

このレスポンスにはボディがありません

🟠403Forbidden

🟠422Parameter Error

リクエストExample

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://service1.exmaple.com/repos///collaborators/' \
--header 'Content-Type: application/json' \
--data '{
    "permission": "triage"
}'

レスポンスExample

403 - 例 1

{
    "message": "string",
    "documentation_url": "string",
    "url": "string",
    "status": "string"
}

更新日時 2025-06-12 06:47:19

Check if a user is a repository collaborator

Remove a repository collaborator