ImmyBotInstall

Overview

The node provides functionality to retrieve a paginated list of computers from an external system via an API. It supports filtering, sorting, and various flags to narrow down the results based on computer status or attributes such as onboarding state, licensing, deletion status, and whether the computer is offline or part of a development lab.

This node is useful in scenarios where you need to manage or audit large inventories of computers, for example:

• Fetching a specific page of computers matching certain criteria for display or reporting.
• Filtering to only show computers that are currently onboarding or stale.
• Retrieving licensed computers for compliance checks.
• Including or excluding offline machines depending on operational needs.

Practical examples:

• An IT admin wants to generate a report of all licensed computers sorted by last check-in date.
• A support team filters to see only computers flagged as stale to prioritize updates.
• A developer queries only development lab computers for testing automation scripts.

Properties

Name	Meaning
Filter	Filter computers by criteria (string expression)
Skip	Number of records to skip for pagination
Sort	Field name to sort the results by
Take	Number of records to take (page size)
Sort Descending	Whether to sort in descending order (true/false)
Onboarding Only	Show only computers that are onboarding (true/false)
Stale Only	Show only stale computers (true/false)
Dev Lab Only	Show only development lab computers (true/false)
Include Offline	Include offline computers in results (true/false)
Tenant ID	Filter by specific tenant ID (number)
Licensed Only	Show only licensed computers (true/false)
Deleted Only	Show only deleted computers (true/false)
Return Individual Items	Return each computer as a separate output item instead of grouping them in an array (true/false)

Output

The node outputs JSON data representing the retrieved computers. The structure typically includes an array of computer objects with their respective properties as returned by the API.

If "Return Individual Items" is enabled, each computer is emitted as a separate output item, allowing downstream nodes to process them individually. Otherwise, all computers are grouped into a single array within one output item.

No binary data output is indicated.

Dependencies

• Requires an API key credential for authentication to the ImmyBot service.
• The base URL for API requests is dynamically constructed using a subdomain from credentials.
• The node expects the ImmyBot API v1 endpoint to be accessible.

Troubleshooting

• Authentication errors: Ensure the API key credential is correctly configured and has necessary permissions.
• Empty results: Check filter criteria and flags like "Onboarding Only" or "Stale Only" which may restrict results too narrowly.
• Pagination issues: Verify "Skip" and "Take" values are set appropriately; requesting beyond available pages will return empty sets.
• Sorting problems: Confirm the "Sort" field matches valid fields supported by the API.
• Network errors: Validate network connectivity and correct subdomain configuration in credentials.

Links and References

• ImmyBot API Documentation (hypothetical link)
• n8n documentation on creating custom nodes