SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Agents → Count Agents

AI-generated

Overview

This node operation counts the number of SentinelOne Agents that match specified filter criteria. It is useful for administrators to quickly determine how many agents meet certain conditions before performing bulk actions or audits. For example, you can count agents by their operational state, installed software version, or network status to plan updates or security measures.

Use Case Examples

  1. Count all active agents in a specific site to assess deployment status.
  2. Count agents with outdated software versions to schedule updates.
  3. Count agents with specific threat statuses to prioritize incident response.

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 Optional filters to narrow down the agents counted, such as K8S node name, core count, ranger statuses, threat creation time, operational states, and many more. These fields allow precise targeting of agents based on various attributes.

Output

JSON

  • count - The count of Agents matching the filter criteria

Dependencies

  • an API key credential for SentinelOne Management Console

Troubleshooting

  • Ensure the API credentials are correctly configured and have the necessary permissions to access agent data.
  • Verify that the filter parameters are valid and correctly formatted to avoid API errors.
  • If pagination is enabled, check the pagination settings to ensure all data is retrieved as expected.
  • Enable debug mode to see the actual API request and response for troubleshooting.

Links

Discussion