SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Agents → Disable Agent

AI-generated

Overview

This node interacts with the SentinelOne Management Console API to disable agents that match specified filters. It is useful for security administrators who want to temporarily disable agents on endpoints without uninstalling them, allowing the agents to maintain connectivity with the management console but run with minimal footprint and no threat detection or mitigation. For example, an admin might disable agents during maintenance or troubleshooting.

Use Case Examples

  1. Disable all agents in a specific group or site to perform maintenance without uninstalling them.
  2. Temporarily disable agents on endpoints that are causing false positives to prevent disruption while investigating.

Properties

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

Output

JSON

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

Dependencies

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

Troubleshooting

  • Ensure the 'data' parameter is included in the request body as it is mandatory for the disable agent action.
  • Check that the user has sufficient permissions (Admin, IR team, or IT role) for the Account, Site, or Group to perform the disable agent action.
  • If receiving 'Insufficient permissions' error, verify the role and scope access of the user.
  • Use the debug option to get detailed request information for troubleshooting API call issues.

Links

Discussion