如何通过GitHub REST API为团队添加仓库并设置Admin权限？

1. 404错误的核心原因 #

你的代码存在三个关键错误：

• 用团队名称替代了team_slug，API无法定位到对应团队，直接导致404。
• 请求方法错误：该API端点要求使用PUT请求，而非你代码里的POST。
• permission参数传递方式错误，且值的格式不符合要求：该参数需放在请求体中，且权限值必须为小写（如admin），而非大写的Admin，也不能作为URL参数传递。

2. team_slug是什么？和团队名称的区别 #

• 团队名称是面向用户的显示名称，比如"前端核心开发组"，可包含空格、特殊字符，甚至可能存在重复。
• team_slug是GitHub为每个团队生成的唯一、URL友好标识：全小写格式，空格替换为连字符，自动移除特殊字符。例如团队名称是"Frontend Core Team"，对应的slug就是frontend-core-team。
• 你可以直接在GitHub团队页面的URL中获取slug：比如团队页面地址为https://github.com/orgs/你的组织名/teams/frontend-core-team，最后一段字符串就是slug。

3. 修正后的代码 #

import requests

# 替换为你的实际数据
org_name = "你的组织名"
team_slug = "你的团队slug"
repo_name = "目标仓库名"
token = "你的GitHub令牌"

# 正确的API端点URL
url = f"https://api.github.com/orgs/{org_name}/teams/{team_slug}/repos/{org_name}/{repo_name}"
headers = {
    "Authorization": f"token {token}",
    "Accept": "application/vnd.github.v3+json"  # 指定API版本，避免兼容性问题
}
# permission参数放在请求体中，值为小写
data = {
    "permission": "admin"
}
response = requests.put(url, headers=headers, json=data)

# 打印响应结果用于排查问题
print(response.status_code)
print(response.json())

额外注意事项 #

• 确保你的GitHub令牌拥有admin:org和repo权限，否则会返回权限不足的错误。
• URL中重复的org_name（即你代码里的owner）是合理的：前半段orgs/{org_name}指定组织，后半段repos/{org_name}/{repo_name}明确目标仓库的归属，只要仓库确实属于该组织，这个结构就没问题。

内容的提问来源于stack exchange，提问作者Whitewind617