如何通过GitHub CLI/API用邮箱邀请成员加入组织？解决404错误

问题原因 #

你使用的/orgs/ORG/teams/TEAM_SLUG/memberships端点仅支持通过用户名添加已有GitHub用户，不接受邮箱参数。直接修改路径并传入邮箱会触发404错误，因为该端点不存在对应的邮箱处理逻辑。

正确解决方案 #

要通过邮箱邀请用户加入团队，需要调用团队的/invitations端点，使用POST方法（而非PUT），传递邮箱和角色参数：

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /orgs/ORG/teams/TEAM_SLUG/invitations \
  -f email='NEW_MEMBER_EMAIL' \
  -f role='maintainer'

注意事项 #

• 确保你的GitHub账号拥有团队的邀请权限（如团队维护者或组织所有者权限）
• 若目标邮箱未注册GitHub，对方会收到注册邀请邮件，完成注册后即可加入团队；若已注册，会直接收到团队加入邀请
• 角色参数仅支持member或maintainer，不可使用其他自定义值

内容的提问来源于stack exchange，提问作者Shreenivasa Y G