Hudu icon

Hudu

Interact with Hudu REST API

Overview

This node interacts with the Hudu REST API to retrieve multiple fields associated with a specific Asset Layout. It is designed to fetch detailed metadata or configuration fields defined within an asset layout in Hudu, which can be useful for inventory management, IT asset tracking, or documentation workflows.

Common scenarios include:

  • Extracting all custom fields of an asset layout to dynamically build forms or reports.
  • Synchronizing asset layout field definitions with other systems.
  • Automating audits or compliance checks by retrieving asset layout configurations.

For example, you might use this node to get all fields of a particular asset layout named "Laptop" to understand what information is tracked for laptops in your organization.

Properties

Name Meaning
Asset Layout Name or ID Select the asset layout from a dropdown list or specify its ID via expression. This identifies which asset layout's fields to retrieve.

Output

The node outputs an array of JSON objects, each representing a field within the specified asset layout. Each object contains details about a single asset layout field, such as its name, type, and other metadata as defined by the Hudu API.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Hudu REST API.
  • Needs an API key credential configured in n8n to authenticate requests.
  • The base URL for the Hudu instance must be set in the credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing Asset Layout ID: Ensure the selected asset layout exists and the ID is correct.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Network connectivity problems: Confirm that the Hudu API endpoint is reachable from the n8n environment.
  • Error messages:

    • "The resource \"asset_layout_fields\" is not known!" — This indicates an internal misconfiguration; ensure the resource parameter is correctly set to "asset_layout_fields".
    • API errors returned from Hudu (e.g., 401 Unauthorized, 404 Not Found) should be checked against the API key validity and asset layout existence.

Links and References

Discussion