Add or update team project permissions

PUT

/orgs/{org}/teams/{team_slug}/projects/{project_id}

Adds an organization project to a team. To add a project to a team or update the team's permission on a project, the authenticated user must have admin permissions for the project. The project and team must be part of the same organization.

Note: You can also specify a team by org_id and team_id using the route PUT /organizations/{org_id}/team/{team_id}/projects/{project_id}.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

204 - Example 1

{}

Request

Path Params

org

string

required

The organization name. The name is not case sensitive.

team_slug

string

required

The slug of the team name.

project_id

integer

required

The unique identifier of the project.

Body Params application/json

object | null

optional

permission

enum<string>

optional

The permission to grant to the team for this project. Default: the team's permission attribute will be used to determine what permission to grant the team on this project. Note that, if you choose not to pass any parameters, you'll need to set Content-Length to zero when calling this endpoint. For more information, see "HTTP verbs."

Allowed values:

readwriteadmin

Examples

Responses

🟢204Response

application/json

Body

object {0}

🟠403Forbidden if the project is not owned by the organization

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

Check team permissions for a project

List team repositories