Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Namespace: microsoft.graph
Important: Microsoft supports Intune /beta APIs, but they are subject to more frequent change. Microsoft recommends using version v1.0 when possible. Check an API's availability in version v1.0 using the Version selector.
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Cancels an already approved instance of an operationApprovalRequest.
This API is available in the following national cloud deployments.
| Global service | US Government L4 | US Government L5 (DOD) | China operated by 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
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) | DeviceManagementConfiguration.Read.All, DeviceManagementRBAC.Read.All |
| Delegated (personal Microsoft account) | Not supported. |
| Application | DeviceManagementConfiguration.Read.All, DeviceManagementRBAC.Read.All |
HTTP Request
POST /deviceManagement/operationApprovalRequests/{operationApprovalRequestId}/cancelApproval
Request headers
| Header | Value |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
| Accept | application/json |
Request body
In the request body, supply JSON representation of the parameters.
The following table shows the parameters that can be used with this action.
| Property | Type | Description |
|---|---|---|
| justification | String | Indicates the justification for cancellation of a request that has already been approved. Maximum length of justification is 1024 characters. For example: 'Cancelled - Change 23423 no longer needed.' |
| approvalSource | operationApprovalSource | Indicates the source of the action on the approval request. Possible values are: unknown, adminConsole, email. Default value is unknown. |
Response
If successful, this action returns a 200 OK response code and a String in the response body.
Example
Request
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceManagement/operationApprovalRequests/{operationApprovalRequestId}/cancelApproval
Content-type: application/json
Content-length: 83
{
"justification": "Justification value",
"approvalSource": "adminConsole"
}
Response
Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 40
{
"value": "Cancel Approval value"
}