SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Agents → Clear Remote Shell

AI-generated

Overview

This node performs the 'Clear Remote Shell' action on SentinelOne Agents via the SentinelOne Management Console API. It is used to clear the 'open shell' flags on the Management Console when Remote Shell sessions are incorrectly shown as open, such as when a shell closes simultaneously with an Agent going offline. This helps maintain accurate Remote Shell session status in the management interface.

Use Case Examples

  1. Clear Remote Shell sessions for specific Agents to reset their Remote Shell status flags in the SentinelOne Management Console.
  2. Use this node to programmatically clear Remote Shell sessions that may have been left open due to connection issues or timeouts.

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 URL, query parameters, headers, and body sent with the API request, if debug mode is enabled.

Dependencies

  • An API key credential for SentinelOne Management Console API

Troubleshooting

  • Ensure the API credentials have permissions to perform agent actions, specifically Remote Shell related permissions.
  • If the node returns permission errors, verify the user role and scope in SentinelOne Management Console.
  • Check network connectivity to the SentinelOne API endpoint.
  • Enable debug mode to see detailed request and response information for troubleshooting.

Links

Discussion