accessReviewScheduleSettings resource type

Namespace: microsoft.graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.


The access review APIs in this section are the recommended access review APIs. The older version, Access reviews, will be deprecated.

The accessReviewScheduleSettings defines the settings of an accessReviewScheduleDefinition.


Property Type Description
mailNotificationsEnabled Boolean Flag to indicate whether emails are enabled/disabled.
reminderNotificationsEnabled Boolean Flag to indicate whether reminders are enabled/disabled.
justificationRequiredOnApproval Boolean Flag to indicate whether reviewers are required to provide justification with their decision.
defaultDecisionEnabled Boolean Flag to indicate whether default decision is enabled/disabled when reviewers do not respond.
defaultDecision String Decision chosen if defaultDecisionEnabled is enabled. Can be one of "Approve", "Deny", or "Recommendation".
instanceDurationInDays Int32 Duration of each recurrence of review (accessReviewInstance) in number of days.
recurrence patternedRecurrence Detailed settings for recurrence. Using standard Outlook recurrence object. Note that dayOfMonth is not supported - use property startDate on recurrenceRange to determine the day the review will start on.
autoApplyDecisionsEnabled Boolean Flag to indicate whether auto-apply feature is enabled.
applyActions accessReviewApplyAction collection Optional field. Describes the actions to take once a review is complete. There are two types that are currently supported: removeAccessApplyAction (default) and disableAndDeleteUserApplyAction. Field only needs to be specified in the case of disableAndDeleteUserApplyAction. See accessReviewApplyAction.
recommendationsEnabled Boolean Flag to indicate whether decision recommendations are enabled/disabled.



JSON representation

The following is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.accessReviewScheduleSettings",
  "mailNotificationsEnabled": "Boolean",
  "reminderNotificationsEnabled": "Boolean",
  "justificationRequiredOnApproval": "Boolean",
  "defaultDecisionEnabled": "Boolean",
  "defaultDecision": "String",
  "instanceDurationInDays": "Integer",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  "autoApplyDecisionsEnabled": "Boolean",
  "applyActions": [
      "@odata.type": "microsoft.graph.removeAccessApplyAction"
  "recommendationsEnabled": "Boolean"