Update Unreviewed Items
Mark all unreviewed items in a review as either revoke or maintain in bulk.
GET https://instance.securid.com/aveksa/command.submit?cmd=updateUnreviewedItems
note
When the review is not in an Active state, the server returns HTTP 200 with status: failure and message: The review is not in an active state. This is not a 4xx error.
caution
The RSA official reference documents a name parameter as mutually exclusive with id. Passing name without id returns 412 The parameter id is required. Always use id.
Request
Parameters
| updateUnreviewedItems | |
| format | properties - (Default) Returns the response as key=value pairs. When multiple objects are returned, values are comma-delimited: key=value1,value2,value3.json - Returns the response as JSON. |
| The review instance ID returned by Get Review Result. | |
The state to apply to all unreviewed items. Valid values: revoke maintain | |
| unassigned | Update unassigned review items. (Default) true |
| assigned | Update assigned review items. (Default) true |
| grouping | When state=revoke, controls how changes are grouped when generating change requests. Valid values: asset component all. Optional. The server accepts requests without this parameter. |
| comment | Optional comment to attach to each updated item. |
Headers
Bearer token | |
| Accept | application/json |
| Content-Type | application/json |
Response
Parameters
type | Executed command name |
name | The name of the review. |
status | success or failure |
message | Returned when status is failure. Describes the reason. |
Examples
Request
- Curl
- Python
- Node.js
curl -K -X GET \
"https://instance.securid.com/aveksa/command.submit?cmd=updateUnreviewedItems&format=json&id=143&state=maintain&grouping=all&comment=Bulk+review+complete" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"
import requests
url = "https://instance.securid.com/aveksa/command.submit"
params = {
"cmd": "updateUnreviewedItems",
"format": "json",
"id": "143",
"state": "maintain",
"grouping": "all",
"comment": "Bulk review complete"
}
headers = {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
}
response = requests.get(url, params=params, headers=headers)
if response.status_code == 200:
data = response.json()
print(data)
else:
print(f"Request failed with status code {response.status_code}")
const axios = require('axios');
const url = "https://instance.securid.com/aveksa/command.submit";
const params = {
cmd: "updateUnreviewedItems",
format: "json",
id: "143",
state: "maintain",
grouping: "all",
comment: "Bulk review complete"
};
const headers = {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
};
axios.get(url, { params, headers })
.then(response => {
if (response.status === 200) {
console.log(response.data);
} else {
console.log(`Request failed with status code ${response.status}`);
}
})
.catch(error => {
console.error('Error:', error);
});
Response
- 200 Success
- 200 Inactive Review
- 401 Invalid Token
- 412 Missing ID
- 412 Missing State
- 412 Invalid State
- 412 Invalid Grouping
- 404 ID Not Found
{
"data": {
"type": "updateUnreviewedItems",
"status": "success",
"name": "UAR-6"
}
}
{
"data": {
"type": "updateUnreviewedItems",
"status": "failure",
"name": "UAR-5",
"message": "The review is not in an active state"
}
}
<html>
<head>
<title>Error</title>
</head>
<body>The token is not valid for the command 'updateUnreviewedItems'. Token is invalid or expired</body>
</html>
<html>
<head>
<title>Error</title>
</head>
<body>The parameter id is required.
Query String=cmd=updateUnreviewedItems&format=json&state=maintain&grouping=all</body>
</html>
<html>
<head>
<title>Error</title>
</head>
<body>The parameter state is required.
Query String=cmd=updateUnreviewedItems&format=json&id=143&grouping=all</body>
</html>
<html>
<head>
<title>Error</title>
</head>
<body>The parameter state must be a valid value: revoke, maintain
Query String=cmd=updateUnreviewedItems&format=json&id=143&state=invalid&grouping=all</body>
</html>
<html>
<head>
<title>Error</title>
</head>
<body>The parameter grouping must be a valid value: asset, component, all
Query String=cmd=updateUnreviewedItems&format=json&id=143&state=revoke&grouping=invalid</body>
</html>
<html>
<head>
<title>Error</title>
</head>
<body>Could not find a review with the id 99999
Query String=cmd=updateUnreviewedItems&format=json&id=99999&state=maintain&grouping=all</body>
</html>
Verified with RSA Governance & Lifecycle version 8.0.0.188886 P10_HF01.
See Also
- Get Review Result: Resolve a
run-idto a review instanceid - Get Review Status: Check whether a review is in Active state before calling this command
- Update Review Items: Update individual review items with specific states