approval.md

title	approval resource type
description	The approval object associated with a userConsentRequest, an accessPackageAssignmentRequest, or a privilegedAccessGroupAssignmentScheduleRequest.
ms.localizationpriority	medium
author	markwahl-msft
ms.subservice	entra-id-governance
doc_type	resourcePageType
ms.date	07/22/2024

approval resource type

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Represents the approval object for decisions associated with a request.

In Microsoft Entra Entitlement Management, the approval object for decisions associated with the accessPackageAssignmentRequest. A single step request can have one step associated with it which approvers can act on. Similarly, a multi-step request can have multiple steps associated with it which approvers can act on. However, in multi-step approvals both pending and previously completed steps are shown.

In userConsentRequests, the approval object for decisions associated with a request.

In Role management, the approval object for decisions to approve or deny role assignments.

In PIM for Microsoft Entra roles, the approval object for decisions to approve or deny requests to activate eligible roles.

In PIM for Groups, the approval object for decisions to approve or deny requests to activate group membership or ownership.

Methods

Method	Return Type	Description
Get	approval	Retrieve the properties of an approval object in entitlement management and PIM.
Filter by current user	approval collection	Retrieve the approval objects for an approver in entitlement management and PIM.

Properties

Property	Type	Description
id	String	The identifier of the approval object. In entitlement management, it's the same identifier as the identifier of the access package assignment request. In PIM for Microsoft Entra roles, it's the same identifier as the identifier of the assignment schedule request. In PIM for Groups, it's the same identifier as the identifier of the assignment schedule request.

Relationships

Relationship	Type	Description
request	request collection	The request that's associated with this approval object.
steps	approvalStep collection	Used to represent the decision associated with a single step in the approval process configured in approvalStage.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.approval",
  "id": "String (identifier)",
  "steps": [{
        "@odata.type": "#microsoft.graph.approvalStep"
    }]
}