Remove team membership for a user

DELETE

/orgs/{org}/teams/{team_slug}/memberships/{username}

To remove a membership between a user and a team, the authenticated user must have 'admin' permissions to the team or be an owner of the organization that the team is associated with. Removing team membership does not delete the user, it just removes their membership from the team.

Team synchronization is available for organizations using GitHub Enterprise Cloud. For more information, see GitHub's products in the GitHub Help documentation.

Note: When you have team synchronization set up for a team with your organization's identity provider (IdP), you will see an error if you attempt to use the API for making changes to the team's membership. If you have access to manage group membership in your IdP, you can manage GitHub team membership through your identity provider, which automatically adds and removes team members in an organization. For more information, see "Synchronizing teams between your identity provider and GitHub."

Note: You can also specify a team by org_id and team_id using the route DELETE /organizations/{org_id}/team/{team_id}/memberships/{username}.

Request

Path Params

Responses

🟢204Response

application/json

Body

🟠403Forbidden if team synchronization is set up

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.github.com/orgs//teams//memberships/'

Response Example

204 - Example 1

{}

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

List team members

Get team membership for a user