团队成员的 REST API 端点

返回的哈希包含一个 role 字段，该字段指的是组织邀请角色，并将是以下值之一：direct_member、admin、billing_manager、hiring_manager 或 reinstate。如果被邀请者不是 GitHub 成员，则返回的哈希中的 login 字段将为 null。

注意：您还可以使用路由 GET /organizations/{org_id}/team/{team_id}/invitations 通过 org_id 和 team_id 指定团队。

团队成员将包括子团队的成员。

要列出团队中的成员，团队必须对经过身份验证的用户可见。

团队成员将包括子团队的成员。

要获取用户在团队中的成员资格，该团队必须对已认证的用户可见。

注意：您也可以使用路由GET /organizations/{org_id}/team/{team_id}/memberships/{username}通过org_id和team_id指定团队。

注意：响应包含成员资格的state和成员的role。

组织所有者的role设置为maintainer。有关maintainer角色的更多信息，请参阅创建团队。

将组织成员添加到团队。已认证的组织所有者或团队维护者可以将组织成员添加到团队。

团队同步适用于使用 GitHub Enterprise Cloud 的组织。有关更多信息，请参阅 GitHub 帮助文档中的GitHub 产品。

注意：当您为组织的标识提供者 (IdP) 设置了团队同步时，如果您尝试使用 API 对团队成员资格进行更改，您将看到错误。如果您有权管理 IdP 中的组成员资格，您可以通过您的标识提供者管理 GitHub 团队成员资格，这会自动在组织中添加和删除团队成员。有关更多信息，请参阅“在您的标识提供者和 GitHub 之间同步团队”。

组织所有者可以将不在团队组织中的人添加到团队。当组织所有者将不在组织中的某人添加到团队时，此端点将通过电子邮件向该人发送邀请。此新创建的成员资格将处于“待处理”状态，直到该人接受邀请，此时成员资格将转换为“活动”状态，并且该用户将被添加为团队成员。

如果用户已经是团队成员，则此端点将更新团队成员的角色。要更新团队成员的成员资格，经过身份验证的用户必须是组织所有者或团队维护者。

注意：您也可以使用路线PUT /organizations/{org_id}/team/{team_id}/memberships/{username}通过org_id和team_id指定团队。

要删除用户与团队之间的成员资格，经过身份验证的用户必须对团队具有“admin”权限，或者是对团队所属组织的所有者。删除团队成员资格不会删除用户，它只是从团队中删除了他们的成员资格。

团队同步适用于使用 GitHub Enterprise Cloud 的组织。有关更多信息，请参阅 GitHub 帮助文档中的GitHub 产品。

注意：当您为组织的标识提供者 (IdP) 设置了团队同步时，如果您尝试使用 API 对团队成员资格进行更改，您将看到错误。如果您有权管理 IdP 中的组成员资格，您可以通过您的标识提供者管理 GitHub 团队成员资格，这会自动在组织中添加和删除团队成员。有关更多信息，请参阅“在您的标识提供者和 GitHub 之间同步团队”。

注意：您也可以使用路线DELETE /organizations/{org_id}/team/{team_id}/memberships/{username}通过org_id和team_id指定团队。

弃用通知：此端点路由已弃用，并将从团队 API 中删除。我们建议您将现有代码迁移到新的 列出待处理的团队邀请 端点。

返回的哈希包含一个 role 字段，该字段指的是组织邀请角色，并将是以下值之一：direct_member、admin、billing_manager、hiring_manager 或 reinstate。如果被邀请者不是 GitHub 成员，则返回的哈希中的 login 字段将为 null。

弃用通知：此端点路由已弃用，并将从团队 API 中删除。我们建议您将现有代码迁移到新的 列出团队成员 端点。

团队成员将包括子团队的成员。

“获取团队成员”端点（如下所述）已弃用。

我们建议您使用 获取用户团队成员资格 端点。它允许您获取活动成员资格和待处理成员资格。

要列出团队中的成员，团队必须对经过身份验证的用户可见。

“添加团队成员”端点（如下所述）已弃用。

我们建议使用 为用户添加或更新团队成员资格 端点。它允许您邀请新的组织成员加入您的团队。

团队同步适用于使用 GitHub Enterprise Cloud 的组织。有关更多信息，请参阅 GitHub 帮助文档中的GitHub 产品。

要将某人添加到团队，经过身份验证的用户必须是组织所有者或他们正在更改的团队的团队维护者。被添加到团队的人必须是团队所属组织的成员。

注意：当您为组织的标识提供者 (IdP) 设置了团队同步时，如果您尝试使用 API 对团队成员资格进行更改，您将看到错误。如果您有权管理 IdP 中的组成员资格，您可以通过您的标识提供者管理 GitHub 团队成员资格，这会自动在组织中添加和删除团队成员。有关更多信息，请参阅“在您的标识提供者和 GitHub 之间同步团队”。

请注意，在调用此端点时，您需要将 Content-Length 设置为零。有关更多信息，请参阅“HTTP 方法”。

“删除团队成员”端点（如下所述）已弃用。

我们建议使用 删除用户的团队成员资格 端点。它允许您删除活动成员资格和待处理成员资格。

团队同步适用于使用 GitHub Enterprise Cloud 的组织。有关更多信息，请参阅 GitHub 帮助文档中的GitHub 产品。

要删除团队成员，经过身份验证的用户必须对团队具有“管理员”权限，或者是对团队所属组织的所有者。删除团队成员不会删除用户，只会将其从团队中删除。

注意：当您为组织的标识提供者 (IdP) 设置了团队同步时，如果您尝试使用 API 对团队成员资格进行更改，您将看到错误。如果您有权管理 IdP 中的组成员资格，您可以通过您的标识提供者管理 GitHub 团队成员资格，这会自动在组织中添加和删除团队成员。有关更多信息，请参阅“在您的标识提供者和 GitHub 之间同步团队”。

弃用通知：此端点路由已弃用，并将从团队 API 中删除。我们建议您将现有代码迁移到新的 获取用户团队成员资格 端点。

团队成员将包括子团队的成员。

要获取用户在团队中的成员资格，该团队必须对已认证的用户可见。

注意：响应包含成员资格的state和成员的role。

组织所有者的role设置为maintainer。有关maintainer角色的更多信息，请参阅创建团队。

弃用通知：此端点路由已弃用，并将从团队 API 中删除。我们建议您将现有代码迁移到新的 添加或更新用户团队成员资格 端点。

团队同步适用于使用 GitHub Enterprise Cloud 的组织。有关更多信息，请参阅 GitHub 帮助文档中的GitHub 产品。

如果用户已经是团队组织的成员，则此端点将把用户添加到团队中。要添加组织成员和团队之间的成员资格，经过身份验证的用户必须是组织所有者或团队维护者。

注意：当您为组织的标识提供者 (IdP) 设置了团队同步时，如果您尝试使用 API 对团队成员资格进行更改，您将看到错误。如果您有权管理 IdP 中的组成员资格，您可以通过您的标识提供者管理 GitHub 团队成员资格，这会自动在组织中添加和删除团队成员。有关更多信息，请参阅“在您的标识提供者和 GitHub 之间同步团队”。

如果用户与团队的组织无关，则此端点将通过电子邮件向用户发送邀请。此新创建的成员资格将处于“待处理”状态，直到用户接受邀请，此时成员资格将过渡到“活动”状态，用户将被添加为团队成员。要添加非关联用户和团队之间的成员资格，经过身份验证的用户必须是组织所有者。

如果用户已经是团队成员，则此端点将更新团队成员的角色。要更新团队成员的成员资格，经过身份验证的用户必须是组织所有者或团队维护者。

弃用通知： 此端点路由已弃用，并将从团队 API 中移除。我们建议您将现有代码迁移到新的 移除团队成员 端点。

团队同步适用于使用 GitHub Enterprise Cloud 的组织。有关更多信息，请参阅 GitHub 帮助文档中的GitHub 产品。

要删除用户与团队之间的成员资格，经过身份验证的用户必须对团队具有“admin”权限，或者是对团队所属组织的所有者。删除团队成员资格不会删除用户，它只是从团队中删除了他们的成员资格。

注意：当您为组织的标识提供者 (IdP) 设置了团队同步时，如果您尝试使用 API 对团队成员资格进行更改，您将看到错误。如果您有权管理 IdP 中的组成员资格，您可以通过您的标识提供者管理 GitHub 团队成员资格，这会自动在组织中添加和删除团队成员。有关更多信息，请参阅“在您的标识提供者和 GitHub 之间同步团队”。