SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Agents → Set External ID

AI-generated

Overview

This node operation allows users to set a Customer Identifier (External ID) for SentinelOne Agents. This identifier is a string used to tag or identify endpoints in the SentinelOne Management Console, facilitating endpoint management based on various criteria such as state, installed applications, or endpoint status. It is particularly useful for organizing and tracking endpoints in large deployments.

Use Case Examples

  1. Tag endpoints with a specific external ID to group them by department or function.
  2. Assign unique customer identifiers to endpoints for easier integration with external asset management systems.

Properties

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

Output

JSON

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

Dependencies

  • An API key credential for SentinelOne API authentication.

Troubleshooting

  • Ensure the API credentials are correctly configured and have the necessary permissions to perform agent actions.
  • Check that the 'resource' is set to 'Agents' and the 'operation' is 'Set External ID'.
  • Verify that the input data and options are correctly formatted, especially the custom JSON body if used.
  • If rate limiting occurs, adjust batching settings to reduce request frequency.
  • Enable debug mode to get detailed request and response information for troubleshooting.

Links

Discussion