更新时间：2026-02-13 GMT+08:00
查询工作项自定义状态的名字是否重复 - CheckStatusName
功能介绍
查询工作项自定义状态的名字是否重复。
调用方法
请参见如何调用API。
授权信息
当前API调用无需身份策略权限。
URI
POST /v2/issue-status/check-name
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
projectUUId | 否 | String | 参数解释： 项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID。 约束限制： 支持中英文的32位字符串。 取值范围： 不涉及。 默认取值： 不涉及。 |
definedName | 否 | String | 参数解释： 自定义状态名称。 约束限制： 支持中英文，不超过15长度的字符串。 取值范围： 不涉及。 默认取值： 不涉及。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
result | result object | 参数解释： 返回信息。 |
status | String | 参数解释： 返回状态。 取值范围： success：返回成功。 error：返回失败。 |
请求示例
POST http://{endpoint}/v2/issue-status/check-name
{
"definedName" : "test1",
"projectUUId" : "d2fc487f5a944d5e88bfbceedb7d6a86"
} 响应示例
状态码：200
CheckStatusName接口成功的响应。
{
"result" : {
"exist" : false
},
"status" : "success"
} 状态码
状态码 | 描述 |
|---|---|
200 | CheckStatusName接口成功的响应。 |
错误码
请参见错误码。
父主题：Scrum项目的状态
