Skip to content

Commit da0f659

Browse files
committed
Update offboard-machine-api.md
1 parent 696bf67 commit da0f659

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

defender-endpoint/api/offboard-machine-api.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.topic: reference
1515
ms.subservice: reference
1616
ms.custom: api
1717
search.appverid: met150
18-
ms.date: 04/17/2024
18+
ms.date: 06/28/2024
1919
---
2020

2121
# Offboard machine API
@@ -52,19 +52,19 @@ Offboard device from Defender for Endpoint.
5252

5353
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Use Defender for Endpoint APIs](apis-intro.md)
5454

55-
Permission type|Permission|Permission display name
56-
---|---|---
57-
Application|Machine.Offboard|'Offboard machine'
58-
Delegated (work or school account)|Machine.Offboard|'Offboard machine'
55+
|Permission type|Permission|Permission display name|
56+
|---|---|---|
57+
|Application|`Machine.Offboard`|`Offboard machine`|
58+
|Delegated (work or school account)|`Machine.Offboard`|`Offboard machine`|
5959

6060
> [!IMPORTANT]
6161
> Microsoft recommends that you use roles with the fewest permissions. This helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.
6262
6363
> [!NOTE]
6464
> When obtaining a token using user credentials:
6565
>
66-
> - The user needs to have a 'Global Administrator' role.
67-
> - The user needs to have access to the device, based on device group settings. For more information, see [Create and manage device groups](../machine-groups.md).
66+
> - The user must have a Global Administrator role.
67+
> - The user must have access to the device, based on device group settings. For more information, see [Create and manage device groups](../machine-groups.md).
6868
>
6969
> Device group creation is supported in Defender for Endpoint Plan 1 and Plan 2.
7070
@@ -87,13 +87,13 @@ Content-Type|string|application/json. **Required**.
8787

8888
In the request body, supply a JSON object with the following parameters:
8989

90-
Parameter|Type|Description
91-
---|---|---
92-
Comment|String|Comment to associate with the action. **Required**.
90+
|Parameter|Type|Description|
91+
|---|---|---|
92+
|Comment|String|Comment to associate with the action. **Required**.|
9393

9494
## Response
9595

96-
If successful, this method returns 200 - Created response code and [Machine Action](machineaction.md) in the response body.
96+
If successful, this method returns `200 - Created response` code and [Machine Action](machineaction.md) in the response body.
9797

9898
## Example
9999

@@ -110,4 +110,5 @@ POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e41
110110
"Comment": "Offboard machine by automation"
111111
}
112112
```
113+
113114
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../../includes/defender-mde-techcommunity.md)]

0 commit comments

Comments
 (0)