1

windows/security/threat-protection/microsoft-defender-atp/api-release-notes.md

@@ -34,9 +34,23 @@ ms.technology: mde
 - Added new API: [Find devices by tag](machine-tags.md). 
 - Added new API: [Import Indicators](import-ti-indicators.md). 
 
+<br>
+<br>
+### 15.12.2020
+<hr>
+
+- Updated [Device](machine.md) entity with IP Interfaces. See [List devices](get-machines.md).
+
+<br>
+<br>
+### 04.12.2020
+<hr>
+
+- Added new API: [Set device value](set-device-value.md).
+
 <br>
 <br>
 ### 01.09.2020
 <hr>
 
-- Added option to expand the Alert object with its related Evidence. See [List Alerts](get-alerts.md)
+- Added option to expand the Alert entity with its related Evidence. See [List Alerts](get-alerts.md)

windows/security/threat-protection/microsoft-defender-atp/set-device-value.md

@@ -73,12 +73,28 @@ Content-Type | string | application/json. **Required**.
 
 ## Request body
 
-```json
-{
-  "DeviceValue": "{device value}"
-}
-```
+In the request body, supply a JSON object with the following parameters:
+
+Parameter |    Type    | Description
+:---|:---|:---
+DeviceValue |    Enum |    Device value. Allowed values are: 'Normal', 'Low' and 'High'. **Required**.
 
 ## Response
 
 If successful, this method returns 200 - Ok response code and the updated Machine in the response body.
+
+## Example
+
+**Request**
+
+Here is an example of a request that adds machine tag.
+
+```
+POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/setDeviceValue
+```
+
+```json
+{
+  "DeviceValue" : "High"
+}
+```