---
canonical_url: "https://docs.composio.dev/toolkits/microsoft_defender"
markdown_url: "https://docs.composio.dev/toolkits/microsoft_defender.md"
product: "platform"
version: null
last_updated: null
---

# Microsoft Defender

Investigate and manage Microsoft Defender security alerts, incidents, hunting results, secure scores, attack simulations, threat intelligence, and threat submissions through Microsoft Graph.

- **Category:** security & identity tools
- **Auth:** OAUTH2, S2S_OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 89
- **Triggers:** 0
- **Slug:** `MICROSOFT_DEFENDER`
- **Version:** 00000000_00

## Tools

### Add Alert Comment

**Slug:** `MICROSOFT_DEFENDER_ADD_ALERT_COMMENT`

Append a comment to a Microsoft Defender security alert. The API does not provide a way to remove the comment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment` | string | Yes | Comment text to append to the alert. |
| `alert_id` | string | Yes | Microsoft Graph alert identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Incident Comment

**Slug:** `MICROSOFT_DEFENDER_ADD_INCIDENT_COMMENT`

Append an analyst comment to a Microsoft Defender incident; comments cannot be removed by this action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment` | string | Yes | Comment text to append to the incident. |
| `incident_id` | string | Yes | Microsoft Graph incident identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Email Submission Policy

**Slug:** `MICROSOFT_DEFENDER_CREATE_EMAIL_SUBMISSION_POLICY`

Create an email threat-submission policy with the supplied settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `policy` | object | Yes | Policy settings to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Simulation

**Slug:** `MICROSOFT_DEFENDER_CREATE_SIMULATION`

Create an attack simulation using payload, login-page, and landing-page resource IDs; acceptance is asynchronous.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `simulation` | object | Yes | Simulation definition to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Email Submission Policy

**Slug:** `MICROSOFT_DEFENDER_DELETE_EMAIL_SUBMISSION_POLICY`

Delete an email threat-submission policy by its Microsoft Graph identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `policy_id` | string | Yes | Microsoft Graph policy identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Simulation

**Slug:** `MICROSOFT_DEFENDER_DELETE_SIMULATION`

Delete an attack simulation campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `simulation_id` | string | Yes | Microsoft Graph simulation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Alert

**Slug:** `MICROSOFT_DEFENDER_GET_ALERT`

Retrieve the documented properties of a Microsoft Defender security alert.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `alert_id` | string | Yes | Microsoft Graph alert identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Article Indicator

**Slug:** `MICROSOFT_DEFENDER_GET_ARTICLE_INDICATOR`

Read a Microsoft Defender Threat Intelligence article indicator.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `article_indicator_id` | string | Yes | Microsoft Graph article indicator identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Email Submission Policy

**Slug:** `MICROSOFT_DEFENDER_GET_EMAIL_SUBMISSION_POLICY`

Get one email threat-submission policy by its Microsoft Graph identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `policy_id` | string | Yes | Microsoft Graph policy identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Host Component

**Slug:** `MICROSOFT_DEFENDER_GET_HOST_COMPONENT`

Read a web component observed on a threat-intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `host_component_id` | string | Yes | Microsoft Graph host component identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Host Cookie

**Slug:** `MICROSOFT_DEFENDER_GET_HOST_COOKIE`

Read a cookie observed on a Microsoft Defender Threat Intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `host_cookie_id` | string | Yes | Microsoft Graph host cookie identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Host Pair

**Slug:** `MICROSOFT_DEFENDER_GET_HOST_PAIR`

Read a parent-child host relationship observed by Microsoft Defender Threat Intelligence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated host-pair properties to return. |
| `host_pair_id` | string | Yes | Microsoft Graph host pair identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Host Port

**Slug:** `MICROSOFT_DEFENDER_GET_HOST_PORT`

Read a port observed on a Microsoft Defender Threat Intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | string | No | Comma-separated non-certificate relationships to expand inline, such as host. |
| `select` | string | No | Comma-separated host-port properties to return. |
| `host_port_id` | string | Yes | Microsoft Graph host port identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Host Reputation

**Slug:** `MICROSOFT_DEFENDER_GET_HOST_REPUTATION`

Get the reputation properties and relationships for a threat-intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `host_id` | string | Yes | Microsoft Graph host identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Host Tracker

**Slug:** `MICROSOFT_DEFENDER_GET_HOST_TRACKER`

Read an internet tracker observed on a Microsoft Defender Threat Intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `host_tracker_id` | string | Yes | Microsoft Graph host tracker identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Host WHOIS

**Slug:** `MICROSOFT_DEFENDER_GET_HOST_WHOIS`

Get the WHOIS record associated with a threat-intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated WHOIS properties to return. |
| `host_id` | string | Yes | Microsoft Graph host identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Incident

**Slug:** `MICROSOFT_DEFENDER_GET_INCIDENT`

Retrieve a Microsoft Defender incident by its identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `incident_id` | string | Yes | Microsoft Graph incident identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Intelligence Profile

**Slug:** `MICROSOFT_DEFENDER_GET_INTELLIGENCE_PROFILE`

Get a Microsoft Defender threat-intelligence profile by identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `intelligence_profile_id` | string | Yes | Microsoft Graph intelligence profile identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Intelligence Profile Indicator

**Slug:** `MICROSOFT_DEFENDER_GET_INTELLIGENCE_PROFILE_INDICATOR`

Get a Microsoft Defender intelligence profile indicator by identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `intelligence_profile_indicator_id` | string | Yes | Microsoft Graph intelligence profile indicator identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Landing Page

**Slug:** `MICROSOFT_DEFENDER_GET_LANDING_PAGE`

Get a landing page associated with an attack simulation campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `landing_page_id` | string | Yes | Microsoft Graph landing page identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Login Page

**Slug:** `MICROSOFT_DEFENDER_GET_LOGIN_PAGE`

Get a login page associated with an attack simulation campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `login_page_id` | string | Yes | Microsoft Graph login page identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Passive DNS Record

**Slug:** `MICROSOFT_DEFENDER_GET_PASSIVE_DNS_RECORD`

Get a Microsoft Defender passive DNS record by identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `passive_dns_record_id` | string | Yes | Microsoft Graph passive DNS record identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Payload

**Slug:** `MICROSOFT_DEFENDER_GET_PAYLOAD`

Get an attack simulation campaign payload.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload_id` | string | Yes | Microsoft Graph payload identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Payload Detail

**Slug:** `MICROSOFT_DEFENDER_GET_PAYLOAD_DETAIL`

Get detailed content for an attack simulation campaign payload.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payload_id` | string | Yes | Microsoft Graph payload identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Secure Score

**Slug:** `MICROSOFT_DEFENDER_GET_SECURE_SCORE`

Retrieve a Microsoft secure score by its provider-generated identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `secure_score_id` | string | Yes | Microsoft Graph secure score identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Secure Score Control Profile

**Slug:** `MICROSOFT_DEFENDER_GET_SECURE_SCORE_CONTROL_PROFILE`

Retrieve a Microsoft secure score control profile by its identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `control_profile_id` | string | Yes | Microsoft Graph control profile identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Simulation

**Slug:** `MICROSOFT_DEFENDER_GET_SIMULATION`

Get an attack simulation campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `simulation_id` | string | Yes | Microsoft Graph simulation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Simulation Automation

**Slug:** `MICROSOFT_DEFENDER_GET_SIMULATION_AUTOMATION`

Get an attack simulation automation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `simulation_automation_id` | string | Yes | Microsoft Graph simulation automation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Simulation Landing Page

**Slug:** `MICROSOFT_DEFENDER_GET_SIMULATION_LANDING_PAGE`

Get the landing page associated with an attack simulation campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `simulation_id` | string | Yes | Microsoft Graph simulation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Simulation Login Page

**Slug:** `MICROSOFT_DEFENDER_GET_SIMULATION_LOGIN_PAGE`

Get the login page associated with an attack simulation campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `simulation_id` | string | Yes | Microsoft Graph simulation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Simulation Operation

**Slug:** `MICROSOFT_DEFENDER_GET_SIMULATION_OPERATION`

Get an attack simulation operation to track a long-running request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `operation_id` | string | Yes | Microsoft Graph operation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Simulation Payload

**Slug:** `MICROSOFT_DEFENDER_GET_SIMULATION_PAYLOAD`

Get the payload associated with an attack simulation campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `simulation_id` | string | Yes | Microsoft Graph simulation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Simulation Report Overview

**Slug:** `MICROSOFT_DEFENDER_GET_SIMULATION_REPORT_OVERVIEW`

Get an overview of an attack simulation and training campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `simulation_id` | string | Yes | Microsoft Graph simulation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subdomain

**Slug:** `MICROSOFT_DEFENDER_GET_SUBDOMAIN`

Get a Microsoft Defender threat-intelligence subdomain by identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subdomain_id` | string | Yes | Microsoft Graph subdomain identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Threat Article

**Slug:** `MICROSOFT_DEFENDER_GET_THREAT_ARTICLE`

Read a Microsoft Defender Threat Intelligence article by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `article_id` | string | Yes | Microsoft Graph article identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Threat Host

**Slug:** `MICROSOFT_DEFENDER_GET_THREAT_HOST`

Read a hostname or IP address detected by Microsoft Defender Threat Intelligence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `host_id` | string | Yes | Microsoft Graph threat-intelligence host identifier, such as a hostname or IP address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Threat Submission

**Slug:** `MICROSOFT_DEFENDER_GET_THREAT_SUBMISSION`

Get one email, file, or URL threat submission by its Microsoft Graph identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `submission_id` | string | Yes | Microsoft Graph identifier of the threat submission. |
| `submission_type` | string ("email" | "file" | "url") | Yes | Kind of threat submission to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Training

**Slug:** `MICROSOFT_DEFENDER_GET_TRAINING`

Get an attack simulation training resource.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `training_id` | string | Yes | Microsoft Graph training identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Training Language Detail

**Slug:** `MICROSOFT_DEFENDER_GET_TRAINING_LANGUAGE_DETAIL`

Get localized language details for an attack simulation training.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression used to restrict results. |
| `training_id` | string | Yes | Microsoft Graph training identifier. |
| `training_language_detail_id` | string | Yes | Microsoft Graph training language detail identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vulnerability

**Slug:** `MICROSOFT_DEFENDER_GET_VULNERABILITY`

Get a Microsoft Defender threat-intelligence vulnerability by identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vulnerability_id` | string | Yes | Microsoft Graph vulnerability identifier, such as a CVE ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vulnerability Component

**Slug:** `MICROSOFT_DEFENDER_GET_VULNERABILITY_COMPONENT`

Get a component associated with a Microsoft Defender vulnerability.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vulnerability_id` | string | Yes | Microsoft Graph vulnerability identifier, such as a CVE ID. |
| `vulnerability_component_id` | string | Yes | Microsoft Graph vulnerability component identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get WHOIS History Record

**Slug:** `MICROSOFT_DEFENDER_GET_WHOIS_HISTORY_RECORD`

Get a Microsoft Defender WHOIS history record by identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated WHOIS history properties to return. |
| `whois_history_record_id` | string | Yes | Microsoft Graph WHOIS history record identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get WHOIS Record

**Slug:** `MICROSOFT_DEFENDER_GET_WHOIS_RECORD`

Get a Microsoft Defender WHOIS record by identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated WHOIS properties to return. |
| `whois_record_id` | string | Yes | Microsoft Graph WHOIS record identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Alerts

**Slug:** `MICROSOFT_DEFENDER_LIST_ALERTS`

Get a page of Microsoft Defender security alerts and their properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression used to restrict alerts. |
| `page_size` | integer | No | Maximum number of alerts to return on this page. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous response. Omit it for the first page and pass it back unchanged to continue. |
| `include_count` | boolean | No | Request the total result count in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Article Indicators

**Slug:** `MICROSOFT_DEFENDER_LIST_ARTICLE_INDICATORS`

List indicators of threat or compromise associated with a threat article.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated indicator properties to return. |
| `page_size` | integer | No | Maximum indicators to return in this page. |
| `article_id` | string | Yes | Microsoft Graph article identifier. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Attack Simulation Repeat Offenders

**Slug:** `MICROSOFT_DEFENDER_LIST_ATTACK_SIMULATION_REPEAT_OFFENDERS`

Get one page of tenant users who yielded to attacks more than once in attack simulation campaigns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Email Submission Policies

**Slug:** `MICROSOFT_DEFENDER_LIST_EMAIL_SUBMISSION_POLICIES`

Get the email threat-submission policies and their current settings.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List End User Notifications

**Slug:** `MICROSOFT_DEFENDER_LIST_END_USER_NOTIFICATIONS`

Get one page of attack simulation end-user notification templates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter. Defaults to global templates because the live workload rejects an empty filter. |
| `select` | string | No | Comma-separated properties to return. |
| `order_by` | string | No | OData ordering expression. |
| `page_size` | integer | No | Maximum records to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Host Components

**Slug:** `MICROSOFT_DEFENDER_LIST_HOST_COMPONENTS`

List web components observed on a Microsoft Defender Threat Intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated component properties to return. |
| `host_id` | string | Yes | Microsoft Graph host identifier. |
| `page_size` | integer | No | Maximum components to return in this page. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Host Cookies

**Slug:** `MICROSOFT_DEFENDER_LIST_HOST_COOKIES`

List cookies observed on a Microsoft Defender Threat Intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated cookie properties to return. |
| `host_id` | string | Yes | Microsoft Graph host identifier. |
| `page_size` | integer | No | Maximum cookies to return in this page. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Host Pairs

**Slug:** `MICROSOFT_DEFENDER_LIST_HOST_PAIRS`

List all, child, or parent host-pair relationships for a threat-intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression used to restrict results. |
| `select` | string | No | Comma-separated host-pair properties to return. |
| `host_id` | string | Yes | Microsoft Graph host identifier. |
| `order_by` | string | No | OData ordering expression, such as 'lastSeenDateTime desc'. |
| `page_size` | integer | No | Maximum host pairs to return in this page. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |
| `relationship` | string ("all" | "children" | "parents") | No | Relationship direction: all pairs, outgoing child pairs, or incoming parent pairs. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Host Passive DNS

**Slug:** `MICROSOFT_DEFENDER_LIST_HOST_PASSIVE_DNS`

List passive-DNS records associated with a Microsoft Defender Threat Intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | Optional OData filter expression. Microsoft Graph supports filtering this route by recordType, but not lastSeenDateTime. |
| `select` | string | No | Comma-separated passive-DNS properties to return. |
| `host_id` | string | Yes | Microsoft Graph host identifier. |
| `order_by` | string | No | OData ordering expression, such as 'lastSeenDateTime desc'. |
| `page_size` | integer | No | Maximum passive-DNS records to return in this page. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Host Ports

**Slug:** `MICROSOFT_DEFENDER_LIST_HOST_PORTS`

Get one page of ports associated with a Microsoft Defender threat-intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | string | No | Comma-separated relationships to expand inline. |
| `select` | string | No | Comma-separated properties to return. |
| `host_id` | string | Yes | Microsoft Graph host identifier. |
| `page_size` | integer | No | Maximum host ports to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Host Reverse Passive DNS

**Slug:** `MICROSOFT_DEFENDER_LIST_HOST_REVERSE_PASSIVE_DNS`

Get one page of passive DNS records that resolve to the specified host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `host_id` | string | Yes | Microsoft Graph host identifier. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Host Subdomains

**Slug:** `MICROSOFT_DEFENDER_LIST_HOST_SUBDOMAINS`

Get one page of subdomain resources associated with a threat-intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `host_id` | string | Yes | Microsoft Graph host identifier. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Host Trackers

**Slug:** `MICROSOFT_DEFENDER_LIST_HOST_TRACKERS`

Get one page of trackers associated with a threat-intelligence host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated properties to return. |
| `host_id` | string | Yes | Microsoft Graph host identifier. |
| `page_size` | integer | No | Maximum host trackers to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Host WHOIS History

**Slug:** `MICROSOFT_DEFENDER_LIST_HOST_WHOIS_HISTORY`

Get one page of historical WHOIS records associated with a host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated WHOIS history properties to return. |
| `host_id` | string | Yes | Microsoft Graph host identifier. |
| `page_size` | integer | No | Maximum WHOIS history records to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Incidents

**Slug:** `MICROSOFT_DEFENDER_LIST_INCIDENTS`

Get one page of Microsoft Defender incidents and an opaque continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | string | No | Comma-separated incident relationships to expand inline. |
| `filter` | string | No | OData filter expression used to restrict incidents. |
| `page_size` | integer | No | Maximum incidents to return on this page. |
| `next_cursor` | string | No | Opaque cursor from a previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total matching incident count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Intelligence Profile Indicators

**Slug:** `MICROSOFT_DEFENDER_LIST_INTELLIGENCE_PROFILE_INDICATORS`

Get one page of indicators associated with a Microsoft Defender intelligence profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |
| `intelligence_profile_id` | string | Yes | Microsoft Graph intelligence profile identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Intelligence Profiles

**Slug:** `MICROSOFT_DEFENDER_LIST_INTELLIGENCE_PROFILES`

Get one page of Microsoft Defender threat-intelligence profiles.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression used to restrict profiles. |
| `search` | string | No | OData search expression supported by this operation. |
| `select` | string | No | Comma-separated profile properties to return. |
| `order_by` | string | No | OData ordering expression. |
| `page_size` | integer | No | Maximum intelligence profiles to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Landing Pages

**Slug:** `MICROSOFT_DEFENDER_LIST_LANDING_PAGES`

Get one page of landing pages for attack simulation campaigns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter. Defaults to global templates because the live workload rejects an empty filter. |
| `select` | string | No | Comma-separated properties to return. |
| `order_by` | string | No | OData ordering expression. |
| `page_size` | integer | No | Maximum records to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Login Pages

**Slug:** `MICROSOFT_DEFENDER_LIST_LOGIN_PAGES`

Get one page of login pages for attack simulation campaigns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter. Defaults to global templates because the live workload rejects an empty filter. |
| `select` | string | No | Comma-separated properties to return. |
| `order_by` | string | No | OData ordering expression. |
| `page_size` | integer | No | Maximum records to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Payloads

**Slug:** `MICROSOFT_DEFENDER_LIST_PAYLOADS`

Get one page of payloads for attack simulation campaigns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter. Defaults to global templates because the live workload rejects an empty filter. |
| `select` | string | No | Comma-separated properties to return. |
| `order_by` | string | No | OData ordering expression. |
| `page_size` | integer | No | Maximum records in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Secure Score Control Profiles

**Slug:** `MICROSOFT_DEFENDER_LIST_SECURE_SCORE_CONTROL_PROFILES`

Return one page of Microsoft secure score control profiles and an opaque continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression used to restrict profiles. |
| `page_size` | integer | No | Maximum profiles to return on this page. |
| `next_cursor` | string | No | Opaque cursor from a previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total matching profile count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Secure Scores

**Slug:** `MICROSOFT_DEFENDER_LIST_SECURE_SCORES`

Return one page of daily Microsoft secure scores and an opaque continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression used to restrict secure scores. |
| `page_size` | integer | No | Maximum secure scores to return on this page. |
| `next_cursor` | string | No | Opaque cursor from a previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total matching secure score count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Simulation Automation Runs

**Slug:** `MICROSOFT_DEFENDER_LIST_SIMULATION_AUTOMATION_RUNS`

Get one page of runs for an attack simulation automation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated properties to return. |
| `page_size` | integer | No | Maximum records in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response. |
| `include_count` | boolean | No | Request the total result count. |
| `simulation_automation_id` | string | Yes | Microsoft Graph simulation automation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Simulation Automations

**Slug:** `MICROSOFT_DEFENDER_LIST_SIMULATION_AUTOMATIONS`

Get one page of attack simulation automations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression. |
| `select` | string | No | Comma-separated properties to return. |
| `order_by` | string | No | OData ordering expression. |
| `page_size` | integer | No | Maximum records in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Simulations

**Slug:** `MICROSOFT_DEFENDER_LIST_SIMULATIONS`

Get one page of attack simulation campaigns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression. |
| `select` | string | No | Comma-separated properties to return. |
| `order_by` | string | No | OData ordering expression. |
| `page_size` | integer | No | Maximum records in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Simulation User Coverage

**Slug:** `MICROSOFT_DEFENDER_LIST_SIMULATION_USER_COVERAGE`

Get one page of attack simulation coverage records for tenant users.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Simulation Users

**Slug:** `MICROSOFT_DEFENDER_LIST_SIMULATION_USERS`

List users and their recorded actions in an attack simulation campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum records in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response. |
| `include_count` | boolean | No | Request the total result count. |
| `simulation_id` | string | Yes | Microsoft Graph simulation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Threat Articles

**Slug:** `MICROSOFT_DEFENDER_LIST_THREAT_ARTICLES`

List Microsoft Defender Threat Intelligence articles one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | OData search expression supported by this operation. |
| `select` | string | No | Comma-separated article properties to return. |
| `order_by` | string | No | OData ordering expression, such as 'createdDateTime desc'. |
| `page_size` | integer | No | Maximum articles to return in this page. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Threat Submissions

**Slug:** `MICROSOFT_DEFENDER_LIST_THREAT_SUBMISSIONS`

List one page of email, file, or URL threat submissions visible to the connected account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression used to restrict results. |
| `page_size` | integer | No | Maximum submissions to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count in the response. |
| `submission_type` | string ("email" | "file" | "url") | Yes | Kind of threat submission to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Trainings

**Slug:** `MICROSOFT_DEFENDER_LIST_TRAININGS`

Get one page of attack simulation training resources.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression. |
| `select` | string | No | Comma-separated properties to return. |
| `order_by` | string | No | OData ordering expression. |
| `page_size` | integer | No | Maximum records in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response. |
| `include_count` | boolean | No | Request the total result count. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Training User Coverage

**Slug:** `MICROSOFT_DEFENDER_LIST_TRAINING_USER_COVERAGE`

Get one page of training coverage records for tenant users in attack simulation campaigns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Vulnerability Components

**Slug:** `MICROSOFT_DEFENDER_LIST_VULNERABILITY_COMPONENTS`

Get one page of components associated with a Microsoft Defender vulnerability.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated component properties to return. |
| `page_size` | integer | No | Maximum vulnerability components to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |
| `vulnerability_id` | string | Yes | Microsoft Graph vulnerability identifier, such as a CVE ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List WHOIS Record History

**Slug:** `MICROSOFT_DEFENDER_LIST_WHOIS_RECORD_HISTORY`

Get one page of historical records for a Microsoft Defender WHOIS record.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `select` | string | No | Comma-separated WHOIS history properties to return. |
| `page_size` | integer | No | Maximum WHOIS history records to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count in the response. |
| `whois_record_id` | string | Yes | Microsoft Graph WHOIS record identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List WHOIS Records

**Slug:** `MICROSOFT_DEFENDER_LIST_WHOIS_RECORDS`

Get one page of WHOIS records from Microsoft Defender threat intelligence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | Yes | Required contact or nameserver search expression, such as 'nameserver/host/id:ns1-39.azure-dns.com'. |
| `select` | string | No | Comma-separated WHOIS properties to return. |
| `order_by` | string | No | OData ordering expression. |
| `page_size` | integer | No | Maximum WHOIS records to return in this page. |
| `next_cursor` | string | No | Opaque continuation cursor from the previous response; omit for the first page. |
| `include_count` | boolean | No | Request the total result count in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Merge Incidents

**Slug:** `MICROSOFT_DEFENDER_MERGE_INCIDENTS`

Merge at least two Microsoft Defender incidents into one incident. This changes incident relationships and cannot be undone; an optional comment also cannot be removed by this action. Requires Microsoft's documented SecurityData.Manage.All permission, which is absent from the current Graph permissions catalog, so authorization may be unavailable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `incident_ids` | array | Yes | IDs of at least two Microsoft Defender incidents to merge. |
| `merge_reasons` | array | No | One or more documented reasons for merging the incidents. |
| `incident_comment` | string | No | Comment to append to the merged incident; it cannot be removed by this action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Move Alerts

**Slug:** `MICROSOFT_DEFENDER_MOVE_ALERTS`

Move one or more Microsoft Defender alerts to a new or existing incident. This changes alert-to-incident relationships and cannot be undone; an optional comment also cannot be removed by this action. Requires Microsoft's documented SecurityData.Manage.All permission, which is absent from the current Graph permissions catalog, so authorization may be unavailable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `alert_ids` | array | Yes | IDs of one or more Microsoft Defender alerts to move. |
| `incident_id` | string | No | Target incident ID. Explicitly pass null to create a new incident; omit to let Microsoft choose the target. |
| `alert_comment` | string | No | Comment to append while moving the alerts; it cannot be removed by this action. |
| `new_correlation_reasons` | array | No | One or more documented reasons for correlating the moved alerts. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Review Email Threat Submission

**Slug:** `MICROSOFT_DEFENDER_REVIEW_EMAIL_THREAT_SUBMISSION`

Record the administrator's review category for an email threat submission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `category` | string ("notJunk" | "spam" | "phishing" | "malware") | Yes | Administrator's review category for the email submission. |
| `submission_id` | string | Yes | Microsoft Graph email-submission identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run Hunting Query

**Slug:** `MICROSOFT_DEFENDER_RUN_HUNTING_QUERY`

Run a Kusto Query Language query against Microsoft Defender advanced-hunting data for the requested time span or workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | The hunting query in Kusto Query Language (KQL). |
| `timespan` | string | No | Time interval to query in ISO 8601 interval, duration, or date-time format. If omitted, Microsoft Defender uses its default 30-day window. |
| `workspace_id` | string | No | GUID of a Log Analytics workspace to target. If omitted or inaccessible, the service uses the caller's primary workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Email Threat

**Slug:** `MICROSOFT_DEFENDER_SUBMIT_EMAIL_THREAT`

Submit email content or a Microsoft Graph message URL for security analysis; this starts an external review workflow and cannot be undone here.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `submission` | object | Yes | Documented email-content or email-URL threat submission. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit File Threat

**Slug:** `MICROSOFT_DEFENDER_SUBMIT_FILE_THREAT`

Submit base64 file content for security analysis; this starts an external review workflow and cannot be undone here.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `submission` | object | Yes | Documented file-content threat submission; URL-based file submissions are unsupported. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit URL Threat

**Slug:** `MICROSOFT_DEFENDER_SUBMIT_URL_THREAT`

Submit a URL for security analysis; this starts an external review workflow and cannot be undone here.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `web_url` | string | Yes | URL to submit for analysis. |
| `category` | string ("notJunk" | "spam" | "phishing" | "malware" | "unknownFutureValue") | Yes | Category being reported for the URL. |
| `odata_type` | string | No | Microsoft Graph URL threat submission type discriminator. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Alert

**Slug:** `MICROSOFT_DEFENDER_UPDATE_ALERT`

Update one or more mutable properties of a Microsoft Defender security alert.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("new" | "inProgress" | "resolved" | "unknownFutureValue") | No | New status for the alert. |
| `alert_id` | string | Yes | Microsoft Graph alert identifier. |
| `assigned_to` | string | No | Owner to assign to the alert, or null to remove the owner. |
| `determination` | string ("unknown" | "apt" | "malware" | "securityPersonnel" | "securityTesting" | "unwantedSoftware" | "other" | "multiStagedAttack" | "compromisedUser" | "phishing" | "maliciousUserActivity" | "clean" | "insufficientData" | "confirmedUserActivity" | "lineOfBusinessApplication" | "unknownFutureValue") | No | New investigation determination for the alert. |
| `classification` | string ("unknown" | "falsePositive" | "truePositive" | "informationalExpectedActivity" | "unknownFutureValue") | No | New classification for the alert. |
| `custom_details` | object | No | User-defined custom fields with string values. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Email Submission Policy

**Slug:** `MICROSOFT_DEFENDER_UPDATE_EMAIL_SUBMISSION_POLICY`

Update one or more settings on an email threat-submission policy.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `policy` | object | Yes | Policy settings to update. |
| `policy_id` | string | Yes | Microsoft Graph policy identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Incident

**Slug:** `MICROSOFT_DEFENDER_UPDATE_INCIDENT`

Update one or more editable properties of a Microsoft Defender incident.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("active" | "resolved" | "redirected" | "unknownFutureValue") | No | New incident status. |
| `summary` | string | No | New incident attack summary. |
| `severity` | string ("unknown" | "informational" | "low" | "medium" | "high" | "unknownFutureValue") | No | New incident severity. |
| `assigned_to` | string | No | New incident owner. |
| `custom_tags` | array | No | Replacement custom tag list. |
| `description` | string | No | New incident description. |
| `incident_id` | string | Yes | Microsoft Graph incident identifier. |
| `display_name` | string | No | New incident name. |
| `determination` | string ("unknown" | "apt" | "malware" | "securityPersonnel" | "securityTesting" | "unwantedSoftware" | "other" | "multiStagedAttack" | "compromisedAccount" | "phishing" | "maliciousUserActivity" | "notMalicious" | "notEnoughDataToValidate" | "confirmedActivity" | "lineOfBusinessApplication" | "unknownFutureValue") | No | New incident determination. |
| `classification` | string ("unknown" | "falsePositive" | "truePositive" | "informationalExpectedActivity" | "unknownFutureValue") | No | New incident classification. |
| `resolving_comment` | string | No | Explanation for the resolution and classification. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Secure Score Control Profile

**Slug:** `MICROSOFT_DEFENDER_UPDATE_SECURE_SCORE_CONTROL_PROFILE`

Update tenant state, assignment, comments, and required vendor information for a Microsoft secure score control profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `control_profile_id` | string | Yes | Microsoft Graph control profile identifier. |
| `vendor_information` | object | Yes | Required vendor and provider details for the control profile update. |
| `control_state_updates` | array | Yes | One or more tenant state updates for the control profile. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Simulation

**Slug:** `MICROSOFT_DEFENDER_UPDATE_SIMULATION`

Update a draft attack simulation, optionally binding a payload by resource ID; acceptance does not mean completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `simulation` | object | Yes | Simulation fields to update. |
| `simulation_id` | string | Yes | Microsoft Graph simulation identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
