Add or update team repository permissions

PUT

/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}

To add a repository to a team or update the team's permission on a repository, the authenticated user must have admin access to the repository, and must be able to see the team. The repository must be owned by the organization, or a direct fork of a repository owned by the organization. You will get a 422 Unprocessable Entity status if you attempt to add a repository to a team that is not owned by the organization. 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."

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}.

For more information about the permission levels, see "Repository permission levels for an organization".

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.github.com/orgs//teams//repos//' \
--header 'Content-Type: application/json' \
--data-raw '{
    "permission": "push"
}'

Response Example

{}

Request

Path Params

Body Params application/json

Examples

Responses

🟢204Response

application/json

Body

Modified at 2023-08-15 02:59:29

Check team permissions for a repository

List child teams