如何通过GitHub GraphQL API添加/移除项目看板列?
能否通过GitHub GraphQL API为项目看板添加或移除列?
核心结论
目前GitHub GraphQL API不支持对经典项目(即你提到的带有3个预设列的看板类型)的列执行创建或删除操作,该功能仅在REST API中提供。
详细说明
- 项目类型差异:GitHub目前存在两种项目体系:
- 经典项目(旧版看板):就是你当前使用的、默认带3列的类型。GraphQL API仅支持查询这类项目的列信息,没有提供修改(增/删)的mutation操作。
- Projects v2(新版项目):如果使用新版项目,GraphQL提供了
createProjectV2Field、deleteProjectV2Field等操作,但这里的"字段"和经典项目的"列"逻辑不同,是面向自定义属性的功能,并非看板列的直接对应。
- 可行的临时方案:
- 继续使用你熟悉的REST API接口(
POST /projects/{project_id}/columns和DELETE /projects/columns/{column_id})完成列的增删操作,再结合GraphQL API查询项目的其他数据——两者的认证机制通用,可在同一流程中混用。 - 若想完全迁移到GraphQL,需考虑升级到Projects v2,但这需要重新适配项目的结构和逻辑。
- 继续使用你熟悉的REST API接口(
官方现状
GitHub官方文档中确实未提供经典项目列增删对应的GraphQL接口,该功能目前仅对REST API开放,暂无明确的更新时间表。
内容的提问来源于stack exchange,提问作者Yohann Msx
相关产品推荐
相关产品推荐

