Help Center/ CodeArts Req/ API Reference/ API/ IPD Feature/Feature Set Management/ Creating Feature Sets (Reserved for Batch Operation)
Updated on 2026-10-13 GMT+08:00

Creating Feature Sets (Reserved for Batch Operation)

Function

This API is used to create a feature set. Currently, only one feature set can be created at a time. The function of batch operations is reserved.

Calling Method

For details, see Calling APIs.

Authorization Information

No identity policy-based permission required for calling this API.

URI

POST /v1/ipdprojectservice/projects/{project_id}/feature-sets

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

32-character ID of a project, which must be unique. Obtain the value by calling the API for querying the IPD project list. The value of id in the response message body is the project ID.

Constraints

N/A

Range

A string of 32 characters consisting of letters and digits.

Default Value

N/A

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

title

Yes

String

Definition

Feature set title.

Constraints

N/A

Range

2 to 256 characters.

Default Value

N/A

parent_id

Yes

String

Definition

Parent feature set ID. Obtain the value of this parameter using the Querying Feature Sets API. The value of id in the response body is the feature set ID.

Constraints

A string of 18 to 19 digits. The parent_id of the root feature set is an empty string or "0".

Range

N/A

Default Value

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

status

String

Definition

Response status.

Range

success: The response is successful.

error: The response failed.

message

String

Error message.

result

FeatureSetOperateParam object

Request parameter object for creating and modifying a feature set.

Table 4 FeatureSetOperateParam

Parameter

Type

Description

id

String

Definition

Feature set ID. The value is automatically generated by the system during creation and is mandatory for update.

Range

N/A

title

String

Definition

Feature set title.

Range

2 to 256 characters.

position_float

Float

Definition

Relative position of the feature set in the directory tree. The value is a floating point number starting from 0. Scientific notation is not supported. This parameter is used to control the sorting of feature sets.

Range

[0,999999999999)

parent_id

String

Definition

Parent feature set ID. Obtain the value of this parameter using the Querying Feature Sets API. The value of id in the response body is the feature set ID.

Range

N/A

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Definition

Error code.

Range

N/A

error_msg

String

Definition

Error description, which is a supplement to error_code.

Range

N/A

Example Requests

POST https://{endpoint}/v1/ipdprojectservice/projects/7102a33f44db4dacab136e1f6890ef86/feature-sets

{
  "title" : "This Is a Feature Set Under 222",
  "parent_id" : "981924601614213120"
}

Example Responses

Status code: 200

{
  "status" : "success",
  "message" : null,
  "result" : {
    "title" : "111c",
    "position_float" : 3,
    "parent_id" : "981957734821834752"
  }
}

Status code: 400

{
  "error_code" : "PM.02174103",
  "error_msg" : "No permission."
}

Status Codes

Status Code

Description

200

Response to a successful operation.

400

Response upon a request failure. For example, the user does not have the operation permission or the project does not exist.

Error Codes

See Error Codes.