如何通过GitHub REST API获取及修改项目自定义议题字段？

获取自定义字段及对应值 #

• 获取项目的所有自定义字段：调用GET /projects/{project_id}/fields接口，返回结果包含字段ID、名称、类型等核心信息，这是后续操作的前提。
• 查看议题在项目中的自定义字段值：首先要找到议题关联到项目后的卡片ID，然后调用GET /projects/columns/cards/{card_id}，返回数据里的project_field_values字段就是该议题对应这个项目的自定义字段值集合。

修改自定义字段值 #

找到目标卡片ID和对应字段ID后，调用PATCH /projects/columns/cards/{card_id}/field-values/{field_id}接口，传入匹配字段类型的新值即可完成修改（比如单选字段要传选项的ID，文本字段直接传字符串）。

你可能遗漏的关键点 #

• 自定义字段属于GitHub Projects而非仓库议题本身：不能通过常规的仓库议题API（如/repos/{owner}/{repo}/issues/{issue_number}）获取或修改，必须使用项目相关的API。
• 区分项目版本：GitHub有经典项目和Projects v2两个版本，对应的API路径不同，要确认自己使用的项目类型匹配正确的API端点。
• 权限要求：操作这些API需要持有包含project或repo权限范围的个人访问令牌，且账号对目标项目有读写权限。

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