Create machine action
Action ID:tools.microsoft_defender_endpoint.create_machine_action
Submit a machine action (for example, isolate or run an antivirus scan) in Microsoft Defender for Endpoint.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/machineaction
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Type of machine action to perform.Allowed values:
Isolate, Unisolate, CollectInvestigationPackage, RunAntivirusScan, RestrictCodeExecution, UnrestrictCodeExecution, StopAndQuarantineFile, LiveResponse, Offboard, RequestSample.Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Optional action parameters payload (for example, {“scanType”: “Quick”} for RunAntivirusScan).Default:
null.Create or update indicator
Action ID:tools.microsoft_defender_endpoint.create_or_update_indicator
Create or update a Microsoft Defender for Endpoint custom indicator of compromise.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/post-ti-indicator
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Enforcement action for the indicator.Allowed values:
Alert, Warn, Block, Audit, BlockAndRemediate, AlertAndBlock, Allowed.Indicator type.Allowed values:
FileSha1, FileSha256, FileMd5, CertificateThumbprint, IpAddress, DomainName, Url.Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Optional ISO 8601 timestamp when the indicator expires (for example, 2025-12-31T00:00:00Z).Default:
null.Optional list of RBAC device group names that the indicator applies to.Default:
null.Get alert
Action ID:tools.microsoft_defender_endpoint.get_alert
Retrieve a Microsoft Defender for Endpoint alert by ID.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/get-alert-info-by-id
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Get file from machine
Action ID:tools.microsoft_defender_endpoint.get_file_from_machine
Request a file from a device using Microsoft Defender Live Response.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/run-live-response
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Absolute file path on the device (escape backslashes, for example C:\\Windows\\Temp\\sample.txt).
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Get incident
Action ID:tools.microsoft_defender_endpoint.get_incident
Retrieve a Microsoft Defender for Endpoint incident by ID.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/exposed-apis-list
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Get machine
Action ID:tools.microsoft_defender_endpoint.get_machine
Retrieve detailed information about a device from Microsoft Defender for Endpoint.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/get-machine-by-id
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Isolate machine
Action ID:tools.microsoft_defender_endpoint.isolate_machine
Isolate a device from the network using Microsoft Defender for Endpoint.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/isolate-machine
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.List alerts
Action ID:tools.microsoft_defender_endpoint.list_alerts
List Microsoft Defender for Endpoint alerts with optional filtering and time range.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/get-alerts
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.OData filter expression to apply (for example, status eq ‘Active’ and severity eq ‘High’).Default:
null.ISO 8601 timestamp to restrict alerts updated after this time (convenience filter applied as lastUpdateTime ge).Default:
null.List incidents
Action ID:tools.microsoft_defender_endpoint.list_incidents
List Microsoft Defender for Endpoint incidents with optional OData filtering.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/exposed-apis-list
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.OData filter expression to apply (for example, status eq ‘Active’ and severity eq ‘High’).Default:
null.Maximum number of incidents to return (maps to $top OData query option).Default:
null.List indicators
Action ID:tools.microsoft_defender_endpoint.list_indicators
Retrieve Microsoft Defender for Endpoint indicators with optional OData filters.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/get-ti-indicators-collection
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.OData filter expression to apply (for example, action eq ‘AlertAndBlock’).Default:
null.List machine actions
Action ID:tools.microsoft_defender_endpoint.list_machine_actions
List Microsoft Defender for Endpoint machine actions with optional filters.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/get-machineactions-collection
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.List machines
Action ID:tools.microsoft_defender_endpoint.list_machines
List Microsoft Defender for Endpoint machines with optional filters.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/get-machines
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.OData filter expression to apply (for example, healthStatus eq ‘Active’).Default:
null.Put file on machine
Action ID:tools.microsoft_defender_endpoint.put_file_on_machine
Copy a file from the Live Response library onto a device.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/run-live-response
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Release machine from isolation
Action ID:tools.microsoft_defender_endpoint.unisolate_machine
Release a device from network isolation in Microsoft Defender for Endpoint.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/unisolate-machine
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Run advanced hunting query
Action ID:tools.microsoft_defender_endpoint.run_advanced_hunting_query
Execute a Microsoft Defender advanced hunting query across Defender for Endpoint data.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/run-advanced-query-api
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Kusto Query Language (KQL) query to run (for example, “DeviceNetworkEvents | take 25”).
Optional AdvancedQueryRunSettings object (for example, {“TimeoutInSeconds”: 120}).Default:
null.Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Run antivirus scan
Action ID:tools.microsoft_defender_endpoint.run_antivirus_scan
Trigger a Microsoft Defender Antivirus scan on a device.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/run-av-scan
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Run live response
Action ID:tools.microsoft_defender_endpoint.run_live_response
Run a sequence of Live Response commands on a device in Microsoft Defender for Endpoint.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/run-live-response
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Ordered list of Live Response commands (each object requires at least a ‘type’ key and optional ‘params’ list of key/value objects).
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Run script on machine
Action ID:tools.microsoft_defender_endpoint.run_script_on_machine
Execute a script from the Live Response library on a device.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/run-live-response
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Update alert
Action ID:tools.microsoft_defender_endpoint.update_alert
Update status, ownership, or classification details for a Microsoft Defender for Endpoint alert.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/update-alert
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Determination that provides additional context for the classification (for example, Malware, SecurityTesting, NotMalicious).Default:
null.Update incident
Action ID:tools.microsoft_defender_endpoint.update_incident
Update classification, determination, or assignment details for a Microsoft Defender for Endpoint incident.
Reference: https://learn.microsoft.com/en-us/defender-endpoint/api/exposed-apis-list
Secrets
Optional secrets:microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_USER_TOKEN.microsoft_defender_endpoint_oauth: OAuth tokenMICROSOFT_DEFENDER_ENDPOINT_SERVICE_TOKEN.
Input fields
Base URL for the Microsoft Defender for Endpoint API.Default:
"https://api.securitycenter.microsoft.com".Allowed values: https://api.securitycenter.microsoft.com, https://api-gcc.securitycenter.microsoft.us, https://api-gov.securitycenter.microsoft.us.Classification to apply to the incident (for example, Unknown, TruePositive, FalsePositive, InformationalExpectedActivity).Default:
null.Determination that provides additional context for the classification (for example, Unknown, Malware, SecurityTesting).Default:
null.