Skip to content

adminconsentrequestpolicy-update.md

Latest commit

 

History

History
110 lines (84 loc) · 3.54 KB

adminconsentrequestpolicy-update.md

File metadata and controls

110 lines (84 loc) · 3.54 KB
title Update adminConsentRequestPolicy
description Update the properties of an adminConsentRequestPolicy object.
author eringreenlee
ms.localizationpriority medium
ms.subservice entra-id-governance
doc_type apiPageType
ms.date 04/04/2024

Update adminConsentRequestPolicy

Namespace: microsoft.graph

Update the properties of an adminConsentRequestPolicy object.

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

[!INCLUDE rbac-adminconsentrequestpolicy-apis-update]

HTTP request

PUT /policies/adminConsentRequestPolicy

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type application/json. Required.

Request body

In the request body, supply a JSON representation of the adminConsentRequestPolicy object.

The following table shows the properties that are required when you update the adminConsentRequestPolicy.

Property Type Description
isEnabled Boolean Specifies whether the admin consent request feature is enabled or disabled.
notifyReviewers Boolean Specifies whether reviewers will receive notifications.
remindersEnabled Boolean Specifies whether reviewers will receive reminder emails.
requestDurationInDays Int32 Specifies the duration the request is active before it automatically expires if no decision is applied.
reviewers accessReviewReviewerScope collection The list of reviewers for the admin consent.

Response

If successful, this method returns a 204 No content response code and an updated adminConsentRequestPolicy object in the response body.

Examples

Request

HTTP

PUT https://graph.microsoft.com/v1.0/policies/adminConsentRequestPolicy 
Content-Type: application/json

{
  "isEnabled": true,
  "notifyReviewers": true,
  "remindersEnabled": true,
  "requestDurationInDays": 5,
  "reviewers": [
    {
      "query": "/users/b6879be8-fb87-4482-a72e-18445d2b5c54",
      "queryType": "MicrosoftGraph"
    },
    {
      "query": "/users/b3427cc5-bf69-4dcd-95f7-ed1eb432f5e9",
      "queryType": "MicrosoftGraph"
    }
  ]
}

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

HTTP/1.1 204 No Content
Content-Type: text/plain