Microsoft Graph · Schema

accessReviewStageSettings

Azure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Tasks

Properties

Name Type Description
decisionsThatWillMoveToNextStage array Indicate which decisions will go to the next stage. Can be a subset of Approve, Deny, Recommendation, or NotReviewed. If not provided, all decisions will go to the next stage. Optional.
dependsOn array Defines the sequential or parallel order of the stages and depends on the stageId. Only sequential stages are currently supported. For example, if stageId is 2, then dependsOn must be 1. If stageId is
durationInDays number The duration of the stage. Required. NOTE: The cumulative value of this property across all stages 1. Will override the instanceDurationInDays setting on the accessReviewScheduleDefinition object. 2.
fallbackReviewers array If provided, the fallback reviewers are asked to complete a review if the primary reviewers don't exist. For example, if managers are selected as reviewers and a principal under review doesn't have a
recommendationInsightSettings array
recommendationsEnabled boolean Indicates whether showing recommendations to reviewers is enabled. Required. NOTE: The value of this property overrides override the corresponding setting on the accessReviewScheduleDefinition object.
reviewers array Defines who the reviewers are. If none is specified, the review is a self-review (users review their own access). For examples of options for assigning reviewers, see Assign reviewers to your access r
stageId string Unique identifier of the accessReviewStageSettings object. The stageId is used by the dependsOn property to indicate the order of the stages. Required.
@odata.type string
View JSON Schema on GitHub

JSON Schema

microsoft-graph-microsoftgraphaccessreviewstagesettings-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.accessReviewStageSettings",
  "title": "accessReviewStageSettings",
  "required": [
    "@odata.type"
  ],
  "type": "object",
  "properties": {
    "decisionsThatWillMoveToNextStage": {
      "type": "array",
      "items": {
        "type": "string",
        "nullable": true
      },
      "description": "Indicate which decisions will go to the next stage. Can be a subset of Approve, Deny, Recommendation, or NotReviewed. If not provided, all decisions will go to the next stage. Optional."
    },
    "dependsOn": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Defines the sequential or parallel order of the stages and depends on the stageId. Only sequential stages are currently supported. For example, if stageId is 2, then dependsOn must be 1. If stageId is 1, don't specify dependsOn. Required if stageId isn't 1."
    },
    "durationInDays": {
      "maximum": 2147483647,
      "minimum": -2147483648,
      "type": "number",
      "description": "The duration of the stage. Required.  NOTE: The cumulative value of this property across all stages  1. Will override the instanceDurationInDays setting on the accessReviewScheduleDefinition object. 2. Can't exceed the length of one recurrence. That is, if the review recurs weekly, the cumulative durationInDays can't exceed 7.",
      "format": "int32"
    },
    "fallbackReviewers": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/microsoft.graph.accessReviewReviewerScope"
      },
      "description": "If provided, the fallback reviewers are asked to complete a review if the primary reviewers don't exist. For example, if managers are selected as reviewers and a principal under review doesn't have a manager in Microsoft Entra ID, the fallback reviewers are asked to review that principal. NOTE: The value of this property overrides the corresponding setting on the accessReviewScheduleDefinition object."
    },
    "recommendationInsightSettings": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/microsoft.graph.accessReviewRecommendationInsightSetting"
      }
    },
    "recommendationsEnabled": {
      "type": "boolean",
      "description": "Indicates whether showing recommendations to reviewers is enabled. Required. NOTE: The value of this property overrides override the corresponding setting on the accessReviewScheduleDefinition object."
    },
    "reviewers": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/microsoft.graph.accessReviewReviewerScope"
      },
      "description": "Defines who the reviewers are. If none is specified, the review is a self-review (users review their own access).  For examples of options for assigning reviewers, see Assign reviewers to your access review definition using the Microsoft Graph API. NOTE: The value of this property overrides the corresponding setting on the accessReviewScheduleDefinition."
    },
    "stageId": {
      "type": "string",
      "description": "Unique identifier of the accessReviewStageSettings object. The stageId is used by the dependsOn property to indicate the order of the stages. Required."
    },
    "@odata.type": {
      "type": "string"
    }
  }
}