文档首页/ 代码托管 CodeArts Repo/ API参考/ API/ V2Project/ 分支关联工作项
更新时间：2025-08-20 GMT+08:00
查看PDF
分享

分支关联工作项

功能介绍

分支关联工作项

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/projects/issues

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

长度为[1,100000]个字符

默认取值：

不涉及。
表2 请求Body参数

参数

是否必选

参数类型

描述

branch

是

String

参数解释：

分支名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

project_id

是

String

参数解释：

项目ID，获取方式请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

related_id

是

Array of strings

参数解释：

待关联工作项id集合

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

repo_id

是

String

参数解释：

仓库ID，可通过查询用户所有仓库接口查询仓库列表获取。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

error

Error object

参数解释：

响应错误。

取值范围：

不涉及。

status

String

参数解释：

响应状态。

取值范围：

  • success，表示接口调用成功。
  • failed，表示接口调用失败。
表4 Error

参数

参数类型

描述

code

String

参数解释：

错误码。

取值范围：

符合错误码格式字符串，长度[0,100]。

message

String

参数解释：

错误信息。

取值范围：

不涉及。

请求示例

POST https://{endpoint}/v2/projects/issues

{
  "project_id" : "a6142fa102b740988fe45cc40254d61c",
  "branch" : "unionsdk",
  "repo_id" : "2111616668",
  "related_id" : [ "5561081" ]
}

响应示例

状态码： 200

OK

{
  "status" : "success"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： V2Project

相关文档