approval resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

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 is the same identifier as the identifier of the access package assignment request.
  • In PIM for Microsoft Entra roles, it is the same identifier as the identifier of the assignment schedule request.
  • In PIM for groups, it is 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"
        }]
    }