api update

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
+

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
 

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)