Microsoft Defender APIInstall

Summary

Retrieve a list of machines that have a specified tag in Microsoft Defender. Optionally filter the search to tags that start with the provided string.

Inputs

• Tag Name (required) — The name of the tag to find machines by
• Use StartsWith Filter — Whether to use a startsWith filter for the tag name (default false)

Output shape

a list of machine objects that match the tag criteria

The output is the JSON array of machines returned by the GET request to /api/machines/findByTag with query parameters 'tag' and optionally 'useStartsWithFilter'. Pagination details are not specified, so the completeness of the list depends on the API's response behavior.

Examples

Example 1: Find machines tagged exactly with 'Finance'

Set 'Tag Name' to 'Finance' and leave 'Use StartsWith Filter' as false.

Example 2: Find machines with tags starting with 'Fin'

Set 'Tag Name' to 'Fin' and enable the 'Use StartsWith Filter' option.

Links

• n8n community nodes installation guide