SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Agents → Count Summary

AI-generated

Overview

This node interacts with the SentinelOne Management Console API to retrieve a summary count of Agents based on specified filters such as Site IDs and Account IDs. It is useful for monitoring the status and distribution of Agents within an organization, including counts of up-to-date, out-of-date, online, infected, and decommissioned Agents. This operation helps administrators quickly assess the health and compliance of their endpoint security deployment.

Use Case Examples

  1. Get a summary count of all Agents for specific Site IDs to monitor endpoint status across multiple locations.
  2. Retrieve the count summary of Agents filtered by Account IDs to evaluate the overall security posture of different business units.

Properties

Name Meaning
Return All Whether to return all results or only a single page. When disabled, no pagination parameters are sent and only one page of results is returned.
Additional Fields.Site Ids List of Site IDs to filter by. Example: "225494730938493804,225494730938493915".
Additional Fields.Account Ids List of Account IDs to filter by. Example: "225494730938493804,225494730938493915".

Output

JSON

  • countSummary - Summary counts of Agents matching the filters, including upToDate, outOfDate, online, infected, decommissioned, and total counts.

Dependencies

  • an API key credential for SentinelOne API authentication

Troubleshooting

  • Ensure the API credentials are correctly configured and have the necessary permissions to access Agent summary data.
  • Verify that the Site IDs and Account IDs provided are valid and exist in the SentinelOne Management Console.
  • Check network connectivity to the SentinelOne API endpoint to avoid request timeouts or connection errors.
  • If pagination is enabled, ensure that the pagination parameters are correctly set to retrieve all data as expected.
  • Review the debug output (if enabled) for detailed request and response information to diagnose issues.

Links

Discussion