ImmyBot icon

ImmyBot

ImmyBot Node

Actions24

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 by ImmyBot. This is useful for IT administrators or automation workflows that need to monitor hardware and software assets, track changes, or generate reports on computer configurations.

A practical example would be automating asset management by periodically retrieving updated inventory details of all computers in an organization and feeding this data into a CMDB (Configuration Management Database) or ticketing system.

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 items are grouped together in a single array output.

Output

The node outputs JSON data representing the computer inventory information 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.
  • If disabled (false), all inventory items are grouped into a single array within one output item.

The exact structure of each inventory item depends on the API response but typically includes details such as hardware specifications, installed software, and other relevant metadata.

No binary data output is indicated in the source code.

Dependencies

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

Troubleshooting

  • Authentication errors: Ensure the API authentication token or OAuth2 credentials are correctly configured and valid.
  • Network issues: Verify network connectivity to the ImmyBot API endpoint and correct subdomain usage.
  • Empty or unexpected output: Check if the requested inventory exists or if filters applied (if any) are correct.
  • Output formatting confusion: If the output appears as a single array but individual items are needed, toggle the "Return Individual Items" property accordingly.

Links and References

Discussion