Remove team membership for a user

DELETE

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

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

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.

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 Enterprise Server 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 Enterprise Server."

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

返回响应

🟢204Response

application/json

Bodyapplication/json

🟠403Forbidden if team synchronization is set up

请求示例

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.github.com/orgs//teams//memberships/' \
--header 'Authorization: Bearer <token>'

响应示例

204 - 示例 1

{}

修改于 2022-08-24 13:05:05

List team members

Get team membership for a user