title | description | ms.localizationpriority | author | ms.subservice | doc_type |
---|---|---|---|---|---|
List approvalSteps |
List approval steps associated with an approval object. |
medium |
markwahl-msft |
entra-id-governance |
apiPageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
List the approvalStep objects associated with an approval. This API request is made by an approver in the following scenarios:
- In entitlement management, providing the identifier of the access package assignment request.
- In PIM for Microsoft Entra roles, providing the identifier of the role assignment schedule request.
- In PIM for groups, providing the identifier of the assignment schedule request.
[!INCLUDE national-cloud-support]
The following tables show the least privileged permission or permissions required to call this API on each supported resource type. Follow best practices to request least privileged permissions. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
[!INCLUDE permissions-table]
[!INCLUDE permissions-table]
To list the approval steps in entitlement management:
GET /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{id}/steps
To list the approval steps in PIM for Microsoft Entra roles:
GET /roleManagement/directory/roleAssignmentApprovals/{id}/steps
To list the approval steps in PIM for groups:
GET /identityGovernance/privilegedAccess/group/assignmentApprovals/{id}/steps
Name | Description |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Don't supply a request body for this method.
If successful, this method returns a 200 OK
response code and a collection of the approvalStep objects in the response body. However, if the caller does not have the right permissions, the method returns a 403 Forbidden
response code.
The following example shows a request.
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/abd306ef-f7b2-4a10-9fd1-493454322489/steps
[!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]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "d4fa4045-4716-436d-aec5-57b0a713f095",
"displayName": null,
"reviewedDateTime": null,
"reviewResult": "NotReviewed",
"status": "InProgress",
"assignedToMe": true,
"justification": "",
"reviewedBy": null
}
]
}