Skip to content

Assign an organization role to a user

PUT
/orgs/{org}/organization-roles/users/{username}/{role_id}

Assigns an organization role to a member of 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.

username
required
string

The handle for the GitHub user account.

role_id
required
integer

The unique identifier of the role.

Response

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

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