Hudu icon

Hudu

Interact with Hudu REST API

Actions100

Overview

This node interacts with the "Asset" resource of the Hudu API, specifically supporting the "Get Many" operation. It retrieves multiple asset records from Hudu based on user-defined filters and pagination options. This is useful for scenarios where you need to bulk fetch asset data for inventory management, reporting, or integration with other systems.

For example, you might use this node to:

  • Retrieve all assets updated in the last 7 days.
  • Fetch a limited number of assets filtered by company or asset layout.
  • Format the output as asset links suitable for populating custom fields in other workflows.

Properties

Name Meaning
Return As Asset Links Boolean option to format the returned assets as asset links compatible with Asset Link custom fields. When enabled, the output will be structured for single (Get) or multiple (Get Many) asset link usage.
Output Field Name The name of the output field under which the array of asset links will be placed when "Return As Asset Links" is enabled. Defaults to "assetLinks".
Return All Boolean option to return all matching assets without limit. If false, results are limited by the "Limit" property.
Limit Maximum number of asset results to return when "Return All" is false. Minimum value is 1. Default is 25.
Filters Collection of filters to narrow down the assets retrieved:
- Archived Boolean filter to include only archived assets.
- Asset Layout Name or ID Select or specify an asset layout by name or ID to filter assets belonging to that layout.
- Company Name or ID Select or specify a company by name or ID to filter assets associated with that company.
- Name Filter assets by their name (string match).
- Primary Serial Filter assets by their primary serial number.
- Search Free text search query to filter assets.
- Slug Filter assets by their URL slug.
- Updated At Date/time filter allowing exact date, date range, or preset ranges (e.g., last 7 days, today, last month) to filter assets by their update timestamp.

Output

The node outputs an array of JSON objects representing the assets retrieved from Hudu. Each object corresponds to one asset and contains its properties as returned by the API.

If "Return As Asset Links" is enabled, the output will include a field (default named assetLinks or as specified) containing an array of asset link objects formatted for use in Asset Link custom fields. This allows easy integration with other nodes or workflows expecting asset link references.

No binary data output is produced by this operation.

Dependencies

  • Requires connection to the Hudu REST API with a valid API key credential configured in n8n.
  • The base URL and API key must be set in the node credentials.
  • Uses internal option loaders to populate selectable lists for companies, asset layouts, and other related entities.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API key credential will cause authentication failures.
    • Using invalid filter values (e.g., non-existent company or asset layout IDs) may result in empty results or errors.
    • Setting "Return All" to true on very large datasets may lead to long execution times or timeouts.

  • Error Messages:

    • "The resource \"assets\" is not known!" — indicates the resource parameter was not correctly set to "assets".
    • API errors related to permissions or invalid parameters will be surfaced; ensure filters and credentials are correct.

  • Resolutions:

    • Verify API credentials and permissions.
    • Double-check filter inputs and use option pickers where available.
    • Use limits and filters to reduce result size if performance issues occur.

Links and References

Discussion