如何通过REST API为JIRA单选类型自定义字段添加新选项

• 调用/rest/api/3/field/customfield_10030时使用了不被支持的HTTP方法：该接口仅允许GET（查询字段基础信息）、DELETE（删除字段）两种请求方法，如果你使用PUT/POST等方法发起请求，就会直接返回405错误，该接口本身不是字段配置修改、选项新增的入口。
• 账号权限不足：如果你的API调用凭证对应的账号没有「JIRA全局配置管理」或「自定义字段管理」权限，部分字段配置类接口会直接返回405拦截，而非常规的403权限错误。

步骤1：获取自定义字段的上下文ID #

调用GET /rest/api/3/field/customfield_10030/context接口，请求头携带正确的身份认证信息（Basic Auth或OAuth2令牌），接口返回结果中即可提取到对应的contextId，全局生效的自定义字段通常只有1个上下文ID。

步骤2：批量写入选项 #

调用PUT /rest/api/3/field/customfield_10030/context/{替换为上一步拿到的contextId}/option接口，请求体格式参考如下：

{
  "options": [
    {
      "value": "CRM客户名称1",
      "disabled": false
    },
    {
      "value": "CRM客户名称2",
      "disabled": false
    }
  ]
}

注意事项 #

• 单次请求最多支持添加1000个选项，CRM客户数据量大时需分批调用
• 需提前拉取JIRA当前已有选项和CRM数据做去重，提交重复的选项值会触发接口报错
• 可在每个选项的参数中添加position字段自定义选项的排序位置
• 若该字段为团队管理项目专属的自定义字段，需确保请求时额外携带项目的projectId参数

完整同步逻辑 #

对接CRM系统时可按以下流程自动化执行：

1. 从CRM拉取全量有效客户列表
2. 调用GET /rest/api/3/field/customfield_10030/context/{contextId}/option拉取JIRA当前已有的自定义字段选项
3. 对比两组数据筛选出需要新增的客户列表
4. 分批调用新增选项接口完成写入

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