跨组织通过GH API添加团队为仓库协作者遇HTTP 422错误求助

核心问题原因 #

你当前使用的/teams/${TEAM_ID}/repos/${GH_ORG}/${REPO} API端点，仅适用于操作当前组织所属团队的仓库关联权限。如果目标团队属于其他组织，调用这个端点会触发验证错误——因为你无法直接修改外部组织团队的仓库关联规则。

解决步骤 #

1. 改用正确的API端点添加外部团队协作者 #

针对跨组织添加团队为仓库协作者，需调用仓库的协作端点，而非团队的仓库关联端点。执行以下命令：

gh api --method PUT -H "Accept: ${MEDIA_TYPE}" --raw-field permission="admin" /repos/${GH_ORG}/${REPO}/collaborators/${EXTERNAL_TEAM_FULL_SLUG}

其中${EXTERNAL_TEAM_FULL_SLUG}格式为外部组织名/团队slug（例如another-org/engineering-team），而非团队ID。

2. 验证媒体类型(MEDIA_TYPE)配置 #

确保你使用的MEDIA_TYPE适配GitHub Enterprise Server 3.7版本，正确值应为：

MEDIA_TYPE="application/vnd.github.enterprise-server-3.7+json"

若省略版本标识，使用通用的application/vnd.github.v3+json也可兼容，但建议匹配你的ES版本。

3. 检查自身组织的协作权限设置 #

• 登录你的组织后台，进入Settings → Member privileges
• 确认已开启允许外部协作者（Allow external collaborators）选项
• 若组织设置了协作白名单，需将目标外部组织加入允许列表

4. 确认外部团队的组织权限 #

目标团队所属的组织管理员需完成以下设置：

• 在组织Settings → Member privileges中开启允许团队被添加为外部协作者选项
• 确保目标团队的权限配置允许成员访问外部仓库

内容的提问来源于stack exchange，提问作者Michal Škultéty