Skip to content

Assign an organization role to a team

PUT
/orgs/{org}/organization-roles/teams/{team_slug}/{role_id}

Assigns an organization role to a team in an organization. For more information on organization roles, see “Using organization roles.”

The authenticated user must be an administrator for the organization to use this endpoint.

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

API method documentation

org
required
string

The organization name. The name is not case sensitive.

team_slug
required
string

The slug of the team name.

role_id
required
integer

The unique identifier of the role.

Response

Response if the organization, team or role does not exist.

Response if the organization roles feature is not enabled for the organization, or validation failed.