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

Updating the Classification

Function

This API is used to update the details of a sensitive data classification, including the classification name, description, and color code, based on the specified classification ID and project ID.

Calling Method

For details, see Calling APIs.

URI

PUT /v1/{project_id}/scan-security-levels/{level_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

level_id

Yes

String

Classification ID, which is used to identify a specific classification.

project_id

Yes

String

Project ID, which is used to identify a specific project.

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

color_number

No

Integer

Risk level color, which is displayed on the GUI.

security_level_desc

No

String

Risk level description.

security_level_name

No

String

Risk level name.

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

msg

String

Returned message, which is used to describe the operation result or status information.

status

String

Returned status, which indicates whether the operation is successful. For example, 200 indicates that the operation is successful, and 400 indicates that the request is invalid.

Status code: 201

Classification updated.

Example Requests

PUT /v1/{project_id}/scan-security-levels/{level_id}

{
  "color_number" : 0,
  "security_level_desc" : "string",
  "security_level_name" : "string"
}

Example Responses

None

Status Codes

Status Code

Description

200

Request succeeded. The update result is returned.

201

Classification updated.

401

Unauthorized. The user is not logged in or the token is invalid.

403

Unauthorized to access the resource.

404

The specified classification is not found.

Error Codes

See Error Codes.