更新时间:2025-09-11 GMT+08:00
分享

修改类型自定义状态

功能介绍

修改类型自定义状态。

调用方法

请参见如何调用API

URI

POST /v2/issue-status/update-tracker-config

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

最小长度:10,最大长度:32768。

默认取值:

不涉及。

表2 请求Body参数

参数

是否必选

参数类型

描述

trackerId

String

参数解释

工作项类型。

约束限制

不涉及。

取值范围

2(任务/Task)

3(缺陷/Bug)

5(Epic)

6(Feature)

7(Story)

默认取值

不涉及。

id

String

参数解释:

自定义状态的id,可通过添加系统自定义状态接口获取,响应体中的result字段中的id就是自定义状态的id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

newPosition

Integer

参数解释:

自定义状态更新后在页面中的位置。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

projectUUId

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

32位的数字和字母组成的字符串。

取值范围

不涉及。

默认取值

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释:

修改类型自定义状态的返回状态。

取值范围:

success:返回成功。

error:返回失败。

请求示例

Post https://{endpoint}/v2/issue-status/update-tracker-config

{
  "trackerId" : "2",
  "id" : "2a27c7a03abd4fbc8dc24d6befcc268b",
  "newPosition" : 4,
  "projectUUId" : "381fcca9c056482d92da3e8b9da71db5"
}

响应示例

状态码:200

修改类型自定义状态接口成功的响应。

{
  "status" : "success"
}

状态码

状态码

描述

200

修改类型自定义状态接口成功的响应。

错误码

请参见错误码

相关文档