Updated on 2025-11-06 GMT+08:00

Updating the Status of the Specified Findings

Function

This API is used to update the status of a specified finding.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the following required identity policy-based permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

AccessAnalyzer:analyzer:updateFindings

Write

analyzer *

g:ResourceTag/<tag-key>

-

-

URI

PUT /v5/analyzers/{analyzer_id}/findings

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

analyzer_id

Yes

String

Unique identifier of an analyzer

Minimum: 1

Maximum: 36

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

ids

No

Array of strings

Unique identifier array of findings to be updated.

Array Length: 1 - 50

resource_urn

No

String

Unique identifier of a resource.

status

Yes

String

Status of the findings to be updated.

  • active

  • archived

Response Parameters

Status code: 200

OK

None

Example Requests

Updating the status of the specified findings

PUT https://{hostname}/v5/analyzers/{analyzer_id}/findings

{
  "ids" : [ "{finding_id}" ],
  "resource_urn" : "iam::{domain_id}:agency:{agency_name}",
  "status" : "active"
}

Example Responses

None

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.