Actions41
- Alarm Actions
- Alarm Category Actions
- Data Collection Actions
- Event Template Actions
- Find Actions
- Object Actions
- Scheduled Task Actions
- Server Actions
- User Actions
Object → Get Sub-Tree
AI-generatedSummary
Retrieves the sub-tree of NetXMS objects beneath a given parent object by calling GET /v1/objects/{objectId}/sub-tree, optionally narrowed by a name/alias substring filter.
Inputs
- Object ID (required) — Numeric ID of the parent object whose sub-tree is requested. Used in the request path.
- Additional Fields > Filter — Substring matched against object name or alias; only matching objects are returned. Sent as the
filterquery parameter, and omitted if empty.
Output shape
The JSON returned by the NetXMS REST API for the sub-tree. If the response is an array, each element becomes a separate n8n item; a single object becomes one item. Each input item produces its own request.
The exact structure of the returned objects is defined by the NetXMS server, not by the node. Each execution logs in to NetXMS with the credentials to get a session token. With Continue On Fail enabled, errors are returned as an item with an
errormessage.
Examples
Example 1: List everything under a container, such as all objects in a site folder.
Resource: Object; Operation: Get Sub-Tree; Object ID: 123; no additional fields.
Example 2: Find objects whose name or alias contains 'switch' under a parent.
Object ID: 123; Additional Fields > Filter: 'switch'.