From 996ed22e654a18d0995a157e5b72eb05b56d973b Mon Sep 17 00:00:00 2001
From: Ben Alfasi <bealfasi@microsoft.com>
Date: Thu, 28 Jan 2021 19:27:34 +0200
Subject: [PATCH] 1

---
 .../api-release-notes.md                      | 16 +++++++++++-
 .../set-device-value.md                       | 26 +++++++++++++++----
 2 files changed, 36 insertions(+), 6 deletions(-)

diff --git a/windows/security/threat-protection/microsoft-defender-atp/api-release-notes.md b/windows/security/threat-protection/microsoft-defender-atp/api-release-notes.md
index 94884f8d28..aef1b00336 100644
--- a/windows/security/threat-protection/microsoft-defender-atp/api-release-notes.md
+++ b/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)
diff --git a/windows/security/threat-protection/microsoft-defender-atp/set-device-value.md b/windows/security/threat-protection/microsoft-defender-atp/set-device-value.md
index 6f1fe23a4a..1164cfc4a4 100644
--- a/windows/security/threat-protection/microsoft-defender-atp/set-device-value.md
+++ b/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"
+}
+```
\ No newline at end of file