accessReviewInstanceDecisionItem: filterByCurrentUser
Namespace: microsoft.graph
Retrieve all decision items for an instance of an access review or a stage of an instance of a multi-stage access review, for which the calling user is the reviewer. The decision items are represented by accessReviewInstanceDecisionItem objects on a given accessReviewInstance or accessReviewStage for which the calling user is the reviewer.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | AccessReview.Read.All, AccessReview.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | AccessReview.Read.All, AccessReview.ReadWrite.All |
HTTP request
To retrieve decisions for an instance of an access review for which the calling user is the reviewer:
GET /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/decisions/filterByCurrentUser(on='reviewer')
To retrieve decisions for a stage in an instance of an multi-stage access review for which the calling user is the reviewer:
GET /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}/stages/{accessReviewStageId}/decisions/filterByCurrentUser(on='reviewer')
Note
Reviewers of multi-stage reviews can retrieve the decisions from previous stages if the decisionHistoriesForReviewersEnabled property is enabled in the settings property of the accessReviewScheduleDefinition object.
Function parameters
In the request URL, provide the following query parameters with values. The following table shows the parameters that are required with this function.
Parameter | Type | Description |
---|---|---|
on | accessReviewInstanceDecisionItemFilterByCurrentUserOptions | Filter to query decision objects for the current user. Possible values are reviewer , unknownFutureValue . Use reviewer . Required. |
Optional query parameters
This method supports the $select
, $filter
(eq
), $orderBy
, $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 accessReviewInstanceDecisionItem 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.
Request headers
Name | Description |
---|---|
Authorization | Bearer {token}. Required. |
Request body
Do not supply a request body for this method.
Response
If successful, this function returns a 200 OK
response code and a accessReviewInstanceDecisionItem collection in the response body.
Examples
Example 1: Retrieve all decisions on an accessReviewInstance for which the calling user is the reviewer
Request
GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/0185aab8-9a7e-44b5-ae36-41b923c3bf87/instances/1234aab8-9a7e-5678-ae36-41b923c3bf87/decisions/filterByCurrentUser(on='reviewer')
Response
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(accessReviewInstanceDecisionItem)",
"@odata.count": 1,
"value": [
{
"@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItem",
"id": "139166ec-d214-4835-95aa-3c1d89581e51",
"accessReviewId": "8d035c9d-798d-47fa-beb4-f986a4b8126f",
"reviewedDateTime": "2021-05-03T19:28:25.02Z",
"decision": "Approve",
"justification": "Christie still needs access to the Marketing group as she works in the Marketing organization.",
"appliedDateTime": null,
"applyResult": "New",
"recommendation": "Deny",
"principalLink": "https://graph.microsoft.com/v1.0/users/1800bb2c-955d-4205-8471-3a6c3116435d",
"resourceLink": null,
"resource": null,
"reviewedBy": {
"id": "36c4c56e-fce3-4e2d-b28e-4ac0c7d2fa10",
"displayName": "MOD Administrator",
"userPrincipalName": "MOD Administrator"
},
"appliedBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "",
"userPrincipalName": ""
},
"target": {
"@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItemUserTarget",
"userId": "1800bb2c-955d-4205-8471-3a6c3116435d",
"userDisplayName": "Christie Cline",
"userPrincipalName": "ChristieC@contoso.com"
},
"principal": {
"@odata.type": "#microsoft.graph.userIdentity",
"id": "1800bb2c-955d-4205-8471-3a6c3116435d",
"displayName": "Christie Cline",
"userPrincipalName": "ChristieC@contoso.com"
}
}
]
}
Example 2: Retrieve all decisions on an accessReviewStage of a multi-stage access review for which the calling user is the reviewer
Request
GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/0185aab8-9a7e-44b5-ae36-41b923c3bf87/instances/1234aab8-9a7e-5678-ae36-41b923c3bf87/stages/9458f255-dff2-4d86-9a05-69438f49d7f8/decisions/filterByCurrentUser(on='reviewer')&$select=accessReviewId,reviewedDateTime,decision,justification,recommendation,reviewedBy,target
Response
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(accessReviewInstanceDecisionItem)",
"@odata.count": 1,
"value": [
{
"@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItem",
"id": "139166ec-d214-4835-95aa-3c1d89581e51",
"accessReviewId": "8d035c9d-798d-47fa-beb4-f986a4b8126f",
"reviewedDateTime": "2021-05-03T19:28:25.02Z",
"decision": "Approve",
"justification": "Christie still needs access to the Marketing group as she works in the Marketing organization.",
"recommendation": "Approve",
"reviewedBy": {
"id": "36c4c56e-fce3-4e2d-b28e-4ac0c7d2fa10",
"displayName": "MOD Administrator",
"userPrincipalName": "MOD Administrator"
},
"target": {
"@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItemUserTarget",
"userId": "1800bb2c-955d-4205-8471-3a6c3116435d",
"userDisplayName": "Christie Cline",
"userPrincipalName": "ChristieC@contoso.com"
},
}
]
}
Feedback
Submit and view feedback for