From f7bc178d87f8da7de031865830adfbbf51526aec Mon Sep 17 00:00:00 2001
From: Beth Levin <elizabeth.levin@microsoft.com>
Date: Tue, 22 Sep 2020 11:32:38 -0700
Subject: [PATCH] api update

---
 .../get-or-set-device-value.md                | 45 +++++++++++++++++++
 .../microsoft-defender-atp/machine.md         |  1 +
 .../threat-and-vuln-mgt-scenarios.md          | 14 ++++++
 3 files changed, 60 insertions(+)
 create mode 100644 windows/security/threat-protection/microsoft-defender-atp/get-or-set-device-value.md

diff --git a/windows/security/threat-protection/microsoft-defender-atp/get-or-set-device-value.md b/windows/security/threat-protection/microsoft-defender-atp/get-or-set-device-value.md
new file mode 100644
index 0000000000..e9b0825ed4
--- /dev/null
+++ b/windows/security/threat-protection/microsoft-defender-atp/get-or-set-device-value.md
@@ -0,0 +1,45 @@
+---
+title: Get or set device value
+description: Learn how to use the Device Value API to get or set the device value
+keywords: apis, graph api, supported apis, get, list, file, information, software id, threat & vulnerability management api, mdatp tvm api
+search.product: eADQiWindows 10XVcnh
+ms.prod: w10
+ms.mktglfcycl: deploy
+ms.sitesec: library
+ms.pagetype: security
+ms.author: ellevin
+author: levinec
+ms.localizationpriority: medium
+manager: dansimp
+audience: ITPro
+ms.collection: M365-security-compliance 
+ms.topic: article
+---
+
+# Get or set device value
+
+[!INCLUDE [Microsoft 365 Defender rebranding](../../includes/microsoft-defender.md)]
+
+
+**Applies to:** [Microsoft Defender Advanced Threat Protection (Microsoft Defender ATP)](https://go.microsoft.com/fwlink/p/?linkid=2069559)
+
+- Want to experience Microsoft Defender ATP? [Sign up for a free trial.](https://www.microsoft.com/microsoft-365/windows/microsoft-defender-atp?ocid=docs-wdatp-exposedapis-abovefoldlink) 
+
+## API description
+Set or GET specific [Machine](machine.md) device value to define it's value to the organization. [Learn more about device value](threat-and-vuln-mgt-scenarios.md#define-a-devices-value-to-the-organization)
+
+
+## HTTP GET request
+```http
+GET /api/machines/{machineId}/getDeviceValue
+```
+
+## HTTP set request
+```http
+POST /api/machines/{machineId}/setDeviceValue
+```
+
+### Possible values
+
+Normal/Low/High
+
diff --git a/windows/security/threat-protection/microsoft-defender-atp/machine.md b/windows/security/threat-protection/microsoft-defender-atp/machine.md
index 074b8fc31f..8874d119f9 100644
--- a/windows/security/threat-protection/microsoft-defender-atp/machine.md
+++ b/windows/security/threat-protection/microsoft-defender-atp/machine.md
@@ -41,6 +41,7 @@ Method|Return Type |Description
 [Add or Remove machine tags](add-or-remove-machine-tags.md) | [machine](machine.md) | Add or Remove tag to a specific machine.
 [Find machines by IP](find-machines-by-ip.md) | [machine](machine.md) collection | Find machines seen with IP.
 [Get missing KBs](get-missing-kbs-machine.md) | KB collection | Get a list of missing KBs associated with the machine ID
+[Get or set device value](get-or-set-device-value.md)| [machine](machine.md) collection | Get or set the value of a device
 
 ## Properties
 
diff --git a/windows/security/threat-protection/microsoft-defender-atp/threat-and-vuln-mgt-scenarios.md b/windows/security/threat-protection/microsoft-defender-atp/threat-and-vuln-mgt-scenarios.md
index 9e981319a8..677ca55787 100644
--- a/windows/security/threat-protection/microsoft-defender-atp/threat-and-vuln-mgt-scenarios.md
+++ b/windows/security/threat-protection/microsoft-defender-atp/threat-and-vuln-mgt-scenarios.md
@@ -82,6 +82,20 @@ Examples of devices that should be marked as high value:
 3. A flyout will appear with the current device value and what it means. Review the value of the device and choose the one that best fits your device.
 ![Example of the device value flyout.](images/tvm-device-value-flyout.png)
 
+## Get or set device value
+
+HTTP GET request
+```http
+GET /api/machines/{machineId}/getDeviceValue
+```
+
+HTTP set request
+```http
+POST /api/machines/{machineId}/setDeviceValue
+```
+
+**Possible values**: Normal/Low/High
+
 ## Related topics
 
 - [Threat and vulnerability management overview](next-gen-threat-and-vuln-mgt.md)