adminConsentRequestPolicy resource type

Namespace: microsoft.graph

Important

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.

Represents the policy for enabling or disabling the Microsoft Entra admin consent workflow. The admin consent workflow allows users to request access for apps that they wish to use and that require admin authorization before users can use the apps to access organizational data. There is a single adminConsentRequestPolicy per tenant.

Methods

Method Return type Description
Get adminConsentRequestPolicy Read the properties and relationships of an adminConsentRequestPolicy object.
Update adminConsentRequestPolicy Update the properties of an adminConsentRequestPolicy object.

Properties

Property Type Description
isEnabled Boolean Specifies whether the admin consent request feature is enabled or disabled. Required.
notifyReviewers Boolean Specifies whether reviewers will receive notifications. Required.
remindersEnabled Boolean Specifies whether reviewers will receive reminder emails. Required.
requestDurationInDays Int32 Specifies the duration the request is active before it automatically expires if no decision is applied.
reviewers accessReviewReviewerScope collection Required.
version Int32 Specifies the version of this policy. When the policy is updated, this version is updated. Read-only.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.adminConsentRequestPolicy",
  "isEnabled": "Boolean",
  "version": "Integer",
  "notifyReviewers": "Boolean",
  "remindersEnabled": "Boolean",
  "requestDurationInDays": "Integer",
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ]
}