协作者的 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，没有任何其他指示表明权限级别已更改。

速率限制

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

从仓库中删除合作者。

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

此端点还

• 取消任何未完成的邀请
• 取消分配用户对任何问题的分配
• 如果用户不是组织成员并且不是任何其他组织仓库的合作者，则删除对组织项目的访问权限。
• 取消收藏仓库
• 更新对软件包的访问权限

将用户作为合作者删除对分支的影响

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

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

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

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

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