Help Center/CodeArts Repo/API Reference/APIs/Project (V2)/Associating Branches with Work Items
Updated on 2025-05-15 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" ]
}

Example Responses

Status code: 200

OK

{
  "status" : "success"
}

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.

Parent topic:Project (V2)