SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Agents → Purge DB

AI-generated

Overview

The SentinelOne node's 'Purge DB' operation under the 'Agents' resource allows users to send a command to Windows endpoints to purge large *.sst files stored by the SentinelOne Agent. These files contain data related to threat tracking, behavioral AI engines, and remediation functionality. This operation is useful for managing disk space on endpoints without active threats, as manual deletion of these files is discouraged. It is particularly beneficial in scenarios where disk space optimization is needed on Windows endpoints managed by SentinelOne.

Use Case Examples

  1. Use the 'Purge DB' operation to clean up large SentinelOne database files on Windows endpoints that are consuming excessive disk space.
  2. Invoke this operation to maintain optimal disk usage on endpoints after threat resolution, ensuring the SentinelOne Agent's data files do not grow uncontrollably.

Properties

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

Output

JSON

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

Dependencies

  • An API key credential for SentinelOne Management Console API

Troubleshooting

  • Ensure the user has sufficient permissions to run the purge DB command; insufficient permissions will cause errors.
  • Do not run the purge DB command if the Agent shows active threats on the endpoint, as it may cause issues.
  • If the command fails, check network connectivity and API authentication credentials.
  • Enable debug mode to get detailed request and response information for troubleshooting.

Links

Discussion