title	accessPackageAssignmentRequest: cancel
description	Cancel accessPackageAssignmentRequest objects that are in a cancelable state.
ms.localizationpriority	medium
author	markwahl-msft
ms.subservice	entra-id-governance
doc_type	apiPageType
ms.date	11/05/2024

accessPackageAssignmentRequest: cancel

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

In Microsoft Entra Entitlement Management, cancel accessPackageAssignmentRequest objects that are in a cancelable state: accepted, pendingApproval, pendingNotBefore, pendingApprovalEscalated.

[!INCLUDE national-cloud-support]

Permissions

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]

[!INCLUDE rbac-entitlement-access-package-assignment-manager-write]

HTTP request

Note

The /accessPackageAssignmentRequests path will be retired soon. Use the /assignmentRequests path instead.

POST /identityGovernance/entitlementManagement/assignmentRequests/{accessPackageAssignmentRequestId}/cancel
POST /identityGovernance/entitlementManagement/accessPackageAssignmentRequests/{id}/cancel

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.

Request body

In the request body, supply a JSON representation of an accessPackageAssignmentRequest object.

For a non-administrator user to cancel their own request, the request must contain the id of the accessPackageAssignmentRequest and a requestStatus with a value of cancelled.

Response

If successful, this method returns a 200 OK response code. It doesn't return anything in the response body.

Examples

Request

The following example shows a request.

HTTP

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests/{id}/cancel

{
  "id":"request-id",
  "requestStatus":"cancelled"
}