Help Center/ CodeArts Build/ API Reference/ APIs/ Group Management/ Moving Build Tasks to a Specified Group
Updated on 2025-08-22 GMT+08:00

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

OK

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

Status Codes

Status Code

Description

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

Error Codes

See Error Codes.