Submit a review for an access certification task
PUT/api/v1/AccessCertificationTask/Review/:taskId
Records the reviewer's approve or deny decisions for activity rows and sets the task status. When the status is Complete (3), the task is closed and each row's decision is recorded as a certification decision for that user's access.
Permission required: Reviewer role, and the signed-in user must be the task's reviewer.
Values for summary.status: 0 = Setup, 1 = ReadyToStart, 2 = Incomplete, 3 = Complete.
Values for activitiesDetail[].status: 0 = NotSet, 1 = Requested, 2 = Approved, 3 = Denied.
Caution: Setting the status to Complete closes the task and records its decisions immediately, and the task can no longer be reviewed. Sending 0 (Setup) or leaving the status out puts the task back into setup, so the reviewer can no longer see or review it.
Request
Responses
- 200
- 400
- 401
- 403
- 404
Returns the task summary and the detail of each activity row.
The task is in setup or already complete, or the review failed.
The signed-in user is not the reviewer for this task.
The signed-in user does not have the required role.
The task does not exist.