Skip to main content

Update or release an access certification task

PUT 
/api/v1/AccessCertificationTask/Tasks/Update/:taskId

Replaces the settings of a task that is still in the Setup (0) state, including its name, description, reviewer, users and status. Set status to ReadyToStart (1) to release the task for review; after that, this call no longer accepts changes. Changing the users can change which activity rows are available, so check the row selection afterward with the rows update call, using the rows this call returns.

Permission required: Admin role.

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: The call replaces the whole task immediately, so any field or user you leave out is cleared. Send the same task ID in the path and the body: only the task in the path is checked for the Setup state, but the task in the body is the one changed.

Request​

Responses​

Returns the task summary and the detail of each available activity row.