# Modify the configuration of a Device Guard payload item within a profile Modify Windows Device Guard Policy payload details ## Endpoints `PUT /api/v1/mdm/profiles/{profile_id}/payloads/windowsdeviceguardpolicy/payloaditems/{payload_id}` ## Request URL `https://{server-hostname}:8383/api/v1/mdm/profiles/{profile_id}/payloads/windowsdeviceguardpolicy/payloaditems/{payload_id}` ### Scope `MDMDeviceMgmt.UPDATE` ### Header `Authorization: d92d4xxxxxxxxxxxxx15f52` ### Request Parameters #### Request Headers - **Content-Type** `string` **Mandatory**: `application/json` - **Accept** `string` **Mandatory**: `application/json` #### Path Parameters - **profile_id** `string` **Mandatory**: Unique identifier of the profile. Obtain from the [Create Profile](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mdm-profiles-create-profile.html) or [Get Profiles](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mdm-profiles-get-profile.html) response. - **payload_id** `string` **Mandatory**: Unique identifier of the payload item. Obtain from the [Get Payload Item IDs](https://www.manageengine.com/products/desktop-central/help/api/onpremise/windows-get-device-guard-payload.html) response. #### Request Body `application/json` JSON Object: - **configure_system_guard** `integer` Optional: Configure System Guard - **enable_virtual_security** `integer` Optional: Enable Virtual Security - **credential_guard** `integer` Optional: Credential Guard ## Sample Request ```curl curl --request PUT \ --url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/windowsdeviceguardpolicy/payloaditems/{payload_id} \ --header 'Accept: application/json' \ --header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \ --header 'Content-Type: application/json' \ --data '{"enable_virtual_security":1,"configure_system_guard":1,"credential_guard":1}' ``` ### Sample Request Body Modify Device Guard payload item ```json { "enable_virtual_security": 1, "configure_system_guard": 1, "credential_guard": 1 } ``` ## Response Parameters ### HTTP Code 200 Response Body: `application/json` JSON Object: - **payload_id** `long`: Unique identifier of the payload item - **configure_system_guard** `integer`: Configure System Guard - **enable_virtual_security** `integer`: Enable Virtual Security - **credential_guard** `integer`: Credential Guard ### Possible Response Codes - **200** `HTTP code` ## Sample Response: HTTP 200 Device Guard payload item successfully modified ```json { "payload_id": 9007199254741296, "enable_virtual_security": 1, "configure_system_guard": 1, "credential_guard": 1 } ``` ![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png) **Duration:** 1 minute | **Threshold:** 60 | **Lock period:** 5 minutes Duration - Time window for the threshold. Threshold - Number of API calls allowed within the specified duration. Lock Period - Wait time before consecutive API requests.