SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Agents → Shutdown

AI-generated

Overview

This node interacts with the SentinelOne Management Console API to perform various operations on Agents, specifically including the ability to remotely shut down endpoints that match specified filters. It is useful for managing endpoint security, maintenance, and performance by sending commands to groups of agents based on filters such as agent IDs, account IDs, or other criteria. For example, an administrator can use this node to shut down all agents in a particular site or group for maintenance purposes.

Use Case Examples

  1. Shut down all agents in a specific group for scheduled maintenance.
  2. Remotely shut down agents that are online and match certain security criteria to prevent spread of infection.

Properties

Name Meaning
Options Collection of optional parameters to customize the API request, including custom request body, headers, query filters, batching settings, debug mode, pagination, and timeout.

Output

JSON

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

Dependencies

  • An API key credential for SentinelOne Management Console API

Troubleshooting

  • Ensure the API credentials are correctly configured and have permissions to perform agent shutdown actions.
  • Check that the filter parameters correctly identify the target agents to avoid no-op or unintended shutdowns.
  • If the API returns permission errors, verify the user role and scope permissions in SentinelOne.
  • Use the debug option to inspect the actual API request and response for troubleshooting.

Links

Discussion