Help Center/ CodeArts Build/ API Reference/ APIs/ Group Management/ Moving Build Tasks to a Specified Group

Updated on 2025-09-25 GMT+08:00

Online Debugging

CLI Examples

View PDF

Moving Build Tasks to a Specified Group

Function

This API is used to move build tasks to a specified group.

Calling Method

For details, see Calling APIs.

URI

POST /v1/job/{project_id}/group/move

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition CodeArts project ID. For details about how to obtain the CodeArts project ID, see Obtaining a CodeArts Project ID. Constraints N/A. Range Use a 32-character string containing a mix of digits and letters. Default Value N/A.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
group_id	No	String	Task group ID.
jobs	No	Array of jobs objects	Task group.

**Table 3** jobs
Parameter	Mandatory	Type	Description
job_id	No	String	Task ID.
job_name	No	String	Task name.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
result	Array of result objects	Returned result.
error	String	Returned error message.
status	String	Returned status information.

**Table 5** result
Parameter	Type	Description
job_id	String	Task ID.
group_path_id	String	Group path.

Status code: 400

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 401

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 403

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 404

**Table 9** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Status code: 500

**Table 10** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Requests

POST https://{endpoint}/v1/job/{project_id}/group/move

Example Responses

Status code: 200

{
  "result" : [ {
    "job_id" : "e3916d5a189340f7a8dca4d5339135e2",
    "group_path_id" : "9ba77d8f7b7641389ef77d43a1b9b054.ed61be9beadf4eebbbbe3806157b1065.81c85f3b1bc34db3a1ce02df598c89e4"
  }, {
    "job_id" : "787ebbc0783b41af939e6666a79ba82d",
    "group_path_id" : "9ba77d8f7b7641389ef77d43a1b9b054.ed61be9beadf4eebbbbe3806157b1065.81c85f3b1bc34db3a1ce02df598c89e4"
  } ],
  "error" : null,
  "status" : "success"
}