文档首页/ 需求管理 CodeArts Req/ API参考/ API/ Scrum项目的状态/ 添加系统自定义状态 - CreateProjectStatusConfig
更新时间:2026-09-15 GMT+08:00
分享

添加系统自定义状态 - CreateProjectStatusConfig

功能介绍

添加系统自定义状态。

调用方法

请参见如何调用API。

授权信息

当前API调用无需身份策略权限。

URI

POST /v2/issue-status/project-status-config

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

definedName

否

String

参数解释:

自定义状态名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

description

否

String

参数解释:

自定义状态的描述。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

projectUUId

否

String

参数解释:

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

约束限制:

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

取值范围:

不涉及。

默认取值:

不涉及。

statusAttribute

否

Integer

参数解释:

自定义状态的属性id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

result

result object

参数解释:

请求返回结果。

status

String

参数解释:

返回结果。

取值范围:

success: 返回成功。

error: 返回失败。

表3 result

参数

参数类型

描述

definedName

String

参数解释:

自定义状态名称。

取值范围:

不涉及。

flag

Integer

参数解释:

状态是否为自定义状态。

取值范围:

0(不是自定义状态)

1(是自定义状态)

id

String

参数解释:

自定义状态id。

取值范围:

不涉及。

position

Integer

参数解释:

自定义状态在状态管理列表的位置。

取值范围:

不涉及。

projectUUId

String

参数解释:

项目的32位UUID。

取值范围:

不涉及。

statusAttribute

Integer

参数解释:

自定义状态属性。

取值范围:

不涉及。

statusId

Integer

参数解释:

自定义状态数字id。

取值范围:

不涉及。

description

String

参数解释:

自定义状态的描述。

取值范围:

不涉及。

请求示例

POST http://{endpoint}/v2/issue-status/project-status-config

{
  "projectUUId" : "af2d9ea776204a4395e238dd156b2ca9",
  "definedName" : "test1",
  "description" : "描述示例。",
  "statusAttribute" : 35098945
}

响应示例

状态码:200

{
  "result" : {
    "id" : "827ae86a6b4c431c88a668dd996b74b1",
    "statusId" : 7,
    "definedName" : "test1",
    "position" : 2,
    "flag" : 1,
    "projectUUId" : "af2d9ea776204a4395e238dd156b2ca9",
    "description" : "描述示例。",
    "statusAttribute" : 34746202
  },
  "status" : "success"
}

状态码

状态码

描述

200

CreateProjectStatusConfig接口成功的响应。

错误码

请参见错误码。

相关文档