Microsoft Defender API icon

Microsoft Defender API

Interact with the Microsoft Defender API

Investigation → Start Investigation

AI-generated

Summary

Start an investigation on a specified machine by providing the machine's ID and an optional comment.

Inputs

  • Machine ID (required) — The ID of the machine to start the investigation on
  • Comment (required) — An optional comment for the investigation

Output shape

a single JSON object response from the Microsoft Defender API indicating the result of starting the investigation

The response shape depends on the Microsoft Defender API's output for the start investigation endpoint. This operation performs a POST request to /api/machines/{machineId}/startInvestigation with the comment in the body.

Links

Discussion