ImmyBotInstall

Overview

The node integrates with the ImmyBot API to retrieve computer inventory data. Specifically, the "Get Inventory" operation under the "Computer" resource fetches detailed inventory information about computers managed in the ImmyBot system. This is useful for IT administrators or automation workflows that need to monitor, audit, or report on hardware and software assets across an organization.

Practical examples include:

• Automatically generating up-to-date asset reports.
• Triggering alerts if certain inventory items are missing or outdated.
• Feeding inventory data into CMDBs (Configuration Management Databases) or other IT management tools.

Properties

Name	Meaning
Return Individual Items	Boolean option to control output format: - true: Each inventory item is returned as a separate output item. - false: All inventory items are grouped together in a single array output.

Output

The node outputs JSON data representing the computer inventory retrieved from the ImmyBot API.

• If Return Individual Items is enabled (true), each inventory item (e.g., each computer or component) is emitted as a separate output item, allowing downstream nodes to process them individually.
• If disabled (false), all inventory items are combined into a single array within one output item.

No binary data output is indicated by the source code or properties.

Dependencies

• Requires an API key credential for authenticating with the ImmyBot API via OAuth2.
• The node uses the subdomain from credentials to construct the base URL for API requests.
• Network access to https://{subdomain}.immy.bot/api/v1 is necessary.

Troubleshooting

• Authentication errors: Ensure the API key credential is correctly configured and has valid permissions.
• Network issues: Verify that the subdomain is correct and accessible from the n8n environment.
• Empty or unexpected data: Check if the ImmyBot account actually contains computer inventory data; also verify the "Return Individual Items" setting matches expected output format.
• API changes: Since the node relies on the ImmyBot API, any breaking changes in their API could cause failures; check for updates or announcements from ImmyBot.

Links and References

• ImmyBot Official Website
• ImmyBot API documentation (typically available via the user’s ImmyBot portal or support channels)