title | description | ms.localizationpriority | author | ms.subservice | doc_type |
---|---|---|---|---|---|
accessReviewInstance: pendingAccessReviewInstances |
Retrieve accessReviewInstance objects pending approval by calling user. |
medium |
jyothig123 |
entra-id-governance |
apiPageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Note
This method will be deprecated and will stop returning data on May 19, 2023. It has been replaced by filterByCurrentUser.
Retrieve the accessReviewInstance objects pending approval by the calling user. A list of zero or more accessReviewInstance objects are returned, of which the calling user is an assigned reviewer.
[!INCLUDE national-cloud-support]
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]
The signed-in user only sees instances of which they are assigned reviewer in the accessReviewScheduleDefinition of the instance.
GET /me/pendingAccessReviewInstances
This method supports $skip
and $top
OData query parameters to help customize the response. For general information, see OData query parameters.
The default page size for this API is 100 accessReviewInstance objects. To improve efficiency and avoid timeouts due to large result sets, apply pagination using the $skip
and $top
query parameters. For more information, see Paging Microsoft Graph data in your app.
None.
Do not supply a request body.
If successful, this method returns a 200 OK
response code and an array of accessReviewInstance objects in the response body.
The following example shows a request to retrieve all the access review series in a tenant.
GET https://graph.microsoft.com/beta/me/pendingAccessReviewInstances?$expand=definition&$top=100&$skip=0
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.count": 1,
"value": [
{
"id": "70a68410-67f3-4d4c-b946-6989e050be19",
"startDateTime": "2020-09-09T15:57:56Z",
"endDateTime": "2020-10-08T15:57:56Z",
"status": "InProgress",
"scope": {
"query": "/groups/04b3d70b-c770-46cb-b751-d857d2beedff/transitiveMembers",
"queryType": "MicrosoftGraph"
},
"definition": {
"id": "70a68410-67f3-4d4c-b946-6989e050be19",
"displayName": "review of leadership",
"createdDateTime": "2020-09-08T15:59:06Z",
"lastModifiedDateTime": "2020-09-09T15:58:24Z",
"status": "InProgress",
"descriptionForAdmins": "review of leadership",
"descriptionForReviewers": "",
"createdBy": {
"id": "957f1027-c0ee-460d-9269-b8828e59e0fe",
"displayName": "MOD Administrator",
"userPrincipalName": "admin@msft.com"
},
"scope": {
"query": "/groups/04b3d70b-c770-46cb-b751-d857d2beedff/transitiveMembers",
"queryType": "MicrosoftGraph"
},
"instanceEnumerationScope": {
"query": "/groups/04b3d70b-c770-46cb-b751-d857d2beedff",
"queryType": "MicrosoftGraph"
},
"reviewers": [
{
"query": "/users/957f1027-c0ee-460d-9269-b8828e59e0fe",
"queryType": "MicrosoftGraph",
"queryRoot": null
}
],
"settings": {
"mailNotificationsEnabled": true,
"reminderNotificationsEnabled": true,
"justificationRequiredOnApproval": true,
"defaultDecisionEnabled": false,
"defaultDecision": "None",
"instanceDurationInDays": 0,
"autoApplyDecisionsEnabled": false,
"recommendationsEnabled": true,
"recurrence": {
"pattern": null,
"range": {
"type": "numbered",
"numberOfOccurrences": 0,
"recurrenceTimeZone": null,
"startDate": "2020-09-09",
"endDate": "2020-10-08"
}
},
"applyActions": [
{
"@odata.type": "#microsoft.graph.removeAccessApplyAction"
}
]
}
}
}
]
}