Help Center/ CodeArts Repo/ API Reference/ APIs/ Project (V2)/ Associating Branches with Work Items

Updated on 2025-03-28 GMT+08:00

View PDF

Associating Branches with Work Items

Function

This API is used to associate work items with a branch.

URI

POST /v2/projects/issues

Request Parameters

**Table 1** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Explanation: User token. It can be obtained by calling the corresponding IAM API. The value of X-Subject-Token in the response header is the user token. Constraints: Mandatory Range: 1–100,000 characters. Default value: None

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
branch	Yes	String	Branch name.
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.
related_id	Yes	Array of strings	Work item set
repo_id	Yes	String	Repository ID.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
error	Error object	Response error.
status	String	Response status.

**Table 4** Error
Parameter	Type	Description
code	String	Error code.
message	String	Error message.

Example Requests

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

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