Update an existing access review campaign. Top-level fields are editable on any review that is not yet COMPLETED. Per-app (apps[].scope_filters) edits are only accepted while the ARDA is still in IN_PREPARATION or ASSIGNING_REVIEWERS status.
Fields absent from the body are left untouched. Setting a target_launch_date moves the review to SCHEDULED; sending it as null unschedules the review and turns off any recurrence. Scheduling fields cannot be changed while the review's apps are being snapshotted (IN_PREPARATION, SCHEDULED_IN_PREPARATION).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Validation error — the request violated a business rule (e.g. duplicate review name, deadline in the past, review not in the required status for this operation).
Forbidden — the caller lacks permission for this change. Creating a review requires the access_reviews.create permission on the domain. Organization admins and App Admins have it, and a custom role can grant it. Changing an existing review requires access_reviews.manage on that review. Organization admins and the review's owners have it, and a custom role can grant it.
Not found — the referenced review / app does not exist.