Microsoft Defender API icon

Microsoft Defender API

Interact with the Microsoft Defender API

Machine → Get Security Recommendations

AI-generated

Summary

Retrieve security recommendations for a specified machine by providing its Machine ID.

Inputs

  • Authentication — Authentication method to use; currently only OAuth2 is supported and set as default.
  • Machine ID (required) — The ID of the machine to get security recommendations for.
  • Request Options — Optional settings to customize the HTTP request such as batching, proxy, timeout, and handling of SSL certificate validation.

Output shape

a JSON object containing the machine's security recommendations as returned by the Microsoft Defender API

The operation makes a GET request to /api/machines/{machineId}/recommendations. No pagination details are specified, so the response likely includes all recommendations for that machine in a single payload.

Examples

Example 1: Retrieve security recommendations for a specific machine

Provide the Machine ID for the machine of interest and have OAuth2 authentication configured for Microsoft Defender API access.

Links

Discussion