SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Agents → Purge Research Data

AI-generated

Overview

This node performs the 'Purge Research Data' action on SentinelOne Agents via the SentinelOne Management Console API. It is used to clean heavy logs from the management system after SentinelOne Research experts resolve issues such as False Positives. This operation is particularly useful for IT administrators who want to maintain optimal system performance by removing unnecessary research data from agents. Note that this command does not affect Linux Agents and requires appropriate permissions (IT role does not have permission).

Use Case Examples

  1. An IT administrator uses this node to purge research data from all Windows and macOS agents after a false positive has been resolved, ensuring the management console is not burdened with obsolete logs.
  2. A security team automates the cleanup of research data from agents to maintain system efficiency and reduce storage usage.

Properties

Name Meaning
Options Additional options for the API request such as custom body, headers, query filters, batching, debug mode, pagination, and timeout settings.

Output

JSON

  • json
    • debug - Debug information including the actual URL, query parameters, headers, and body sent with the API request, if debug mode is enabled.

Dependencies

  • An API key credential for authenticating with the SentinelOne Management Console API.

Troubleshooting

  • Ensure the user role has IT permissions as the command does not affect Linux Agents and the IT role does not have permission to run this command.
  • Check network connectivity and API credentials if the request fails.
  • Enable debug mode to get detailed request and response information for troubleshooting.

Links

Discussion