Actions60
- Agent Actions
- Alert Actions
- Box Actions
- Extension Actions
- Flag Actions
- Location Actions
- Organization Actions
- Policy Actions
- Quarantined File Actions
- Report Actions
- Suppression Rule Actions
- Target Actions
- User Actions
- Webhook Actions
Target → List Agents
AI-generatedSummary
Lists the agents (endpoints) assigned to a given Datto EDR target group, either all of them or up to a limit.
Inputs
- Target ID (required) — ID of the target group whose agents to list. The operation throws an error if it is empty.
- Return All — If true, pages through every result (100 per request, up to 200 pages) and returns them all. Defaults to false.
- Limit — Maximum number of agents to return (minimum 1, default 50). Shown only when Return All is false.
Output shape
A list of n8n items, one per agent, containing the agent JSON records returned by the Datto EDR API's Targets/{targetId}/agents endpoint.
If no agents are found, a single item is emitted with found: 0 plus the resource and operation names. With Return All, the operation errors if more than 200 pages are returned. API errors (401, 403, 404, 429) are surfaced as node errors. With Continue On Fail enabled, an item with an error message is emitted instead.
Examples
Example 1: Get the first 50 agents in a target group.
Resource: Target, Operation: List Agents, Target ID: the group's ID, Return All: off, Limit: 50.
Example 2: Export every endpoint in a target group for an inventory report.
Resource: Target, Operation: List Agents, Target ID: set via expression from an earlier node, Return All: on.