协作者的 REST API 端点

对于组织拥有的仓库，协作者列表包括外部协作者、作为直接协作者的组织成员、通过团队成员资格获得访问权限的组织成员、通过默认组织权限获得访问权限的组织成员以及组织所有者。组织成员对组织拥有的仓库具有写入、维护或管理员权限，可以使用此端点。

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

经过身份验证的用户必须对仓库具有推送访问权限才能使用此端点。

OAuth 应用程序令牌和个人访问令牌（经典）需要 read:org 和 repo 范围才能使用此端点。

对于组织拥有的仓库，合作者列表包括外部合作者、作为直接合作者的组织成员、通过团队成员资格获得访问权限的组织成员、通过默认组织权限获得访问权限的组织成员以及组织所有者。

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

经过身份验证的用户必须对仓库具有推送访问权限才能使用此端点。

OAuth 应用程序令牌和个人访问令牌（经典）需要 read:org 和 repo 范围才能使用此端点。

此端点会触发 通知。使用此端点过快地创建内容可能会导致二级速率限制。有关更多信息，请参阅“API 速率限制”和“使用 REST API 的最佳实践”。

企业管理员可能会限制添加外部合作者。有关更多信息，请参阅“在企业中执行仓库管理策略”。

有关权限级别的更多信息，请参阅“组织拥有的仓库的权限级别”。当组织基础角色存在时，对组织成员可以授予哪些权限存在限制。在这种情况下，授予的权限必须等于或高于组织基础权限。否则，请求将失败，并显示

Cannot assign {member} permission of {role name}

请注意，如果您选择不传递任何参数，则在调用此端点时需要将 Content-Length 设置为零。有关更多信息，请参阅“HTTP 方法”。

受邀者将收到一条通知，告知他们已受邀加入仓库，他们必须接受或拒绝邀请。他们可以通过通知页面、收到的电子邮件或使用 API 来执行此操作。

更新现有合作者的权限级别

该端点也可以用于更改现有协作者的权限，而无需先删除并重新添加协作者。要更改权限，请使用相同的端点并传递不同的permission参数。响应将是204，没有其他指示权限级别已更改。

速率限制

您每天最多可以向一个仓库发送 50 个邀请。请注意，如果您邀请组织成员加入组织仓库，则没有限制。

从仓库中删除协作者。

要使用此端点，经过身份验证的用户必须是仓库的管理员或将自己作为目标进行删除。

此端点还

• 取消任何未完成的邀请
• 取消分配用户对任何问题的分配
• 如果用户不是组织成员，并且不是任何其他组织存储库的合作者，则会移除其对组织项目的访问权限。
• 取消对存储库的关注。
• 更新对包的访问权限。

移除用户作为合作者会对分支产生以下影响。

• 如果用户通过其对该存储库的成员资格访问了分支，则用户也将从分支中移除。
• 如果用户拥有该存储库的自己的分支，则该分支将被删除。
• 如果用户仍然对存储库具有读取权限，则来自分支的该用户的打开的拉取请求将被拒绝。

注意：用户仍然可以通过组织权限（如基本存储库权限）访问存储库。

虽然 API 会立即响应，但额外的权限更新可能需要一些额外的时间才能在后台完成。

有关分支权限的更多信息，请参阅“关于分支的权限和可见性”。

检查合作者的存储库权限。可能的存储库权限为 admin、write、read 和 none。

注意：permission 属性提供 admin、write、read 和 none 的传统基本角色，其中 maintain 角色映射到 write，triage 角色映射到 read。要确定分配给合作者的角色，请参阅 role_name 属性，它将提供完整的角色名称，包括自定义角色。permissions 哈希也可以用于确定合作者对存储库的哪个基本访问级别。