GitHub Enterprise中GITHUB_TOKEN调用团队权限API报NotFound问题

1. 补全GITHUB_TOKEN的权限配置 #

GitHub Actions自动生成的GITHUB_TOKEN默认权限极低（仅包含contents: read等基础权限），而向仓库添加团队并配置推送权限需要仓库管理员权限。你必须在Workflow文件中显式声明所需权限：

jobs:
  add-team:
    runs-on: ubuntu-latest
    permissions:
      admin: write  # 赋予仓库管理员权限，允许修改团队关联及权限
    steps:
      - name: Add testgroup to repo with push access
        uses: octokit/request-action@v2.x
        with:
          route: PUT /repos/{owner}/{repo}/teams/{team_id}
          owner: ${{ github.repository_owner }}
          repo: ${{ github.event.repository.name }}
          team_id: 12345  # 替换为你的testgroup团队ID
          permission: push
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

如果是GitHub Enterprise环境，还要确认组织未通过权限策略禁用GITHUB_TOKEN的管理员权限。

2. 核对团队标识的准确性 #

NotFound错误大概率是API请求中的团队信息有误：

• 不要直接用团队名称（如testgroup）调用API，必须使用团队ID或组织/团队slug组合（格式为your-org/testgroup）。你可以通过调用GET /orgs/{org}/teams API获取目标团队的ID和slug。
• 确认团队属于当前仓库所在的组织，且拼写、大小写完全匹配（GitHub Enterprise的团队slug可能区分大小写）。

3. 检查组织级别的Actions权限限制 #

GitHub Enterprise的组织管理员可能设置了规则，禁止GITHUB_TOKEN执行团队管理操作：

• 登录你的GHE实例，进入组织的「Settings」→「Actions」→「General」页面，检查是否开启了「Allow GitHub Actions to create and manage organizations」选项。
• 查看组织「Permissions」下的相关设置，确认GITHUB_TOKEN被允许进行团队关联操作。

4. 确认API端点适配GHE环境 #

GitHub Enterprise的API域名和GitHub.com不同，若请求发错地址会直接返回NotFound：

• GHE的API前缀为https://你的GHE域名/api/v3/，而非https://api.github.com/。如果使用octokit/request-action这类工具，需显式设置GITHUB_API_URL环境变量：

env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  GITHUB_API_URL: https://your-ghe-domain/api/v3/

内容的提问来源于stack exchange，提问作者byle.05