Updated on 2026-10-13 GMT+08:00

Editing a Feature Set

Function

This API is used to modify the title, parent feature set, and relative position information of a feature set.

Calling Method

For details, see Calling APIs.

Authorization Information

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

URI

PUT /v1/ipdprojectservice/projects/{project_id}/feature-sets/{feature_set_id}

**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
feature_set_id	Yes	String	Definition Feature set ID, which is unique. 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 or 19 digits. Range N/A Default Value N/A

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
title	No	String	Definition Feature set title. Constraints N/A Range 2 to 256 characters. Default Value N/A
position_float	No	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. Constraints Scientific notation is not supported. Range [0,999999999999) 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 This parameter is mandatory. The original parent feature set ID needs to be specified only when modifying the location and title. The target feature set ID shall be specified when modifying the feature set directory. A string of 18 to 19 digits. 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

PUT https://{endpoint}/v1/ipdprojectservice/projects/{project_id}/feature-sets/{feature_set_id}

{
  "title" : "This Is a Two-Layer Feature Set 3",
  "position_float" : 1,
  "parent_id" : "981924129047359488"
}

Example Responses