Hudu icon

Hudu

Interact with Hudu REST API

Overview

This node interacts with the "Asset Password" resource of the Hudu API, specifically supporting the "Get Many" operation. It allows users to retrieve multiple asset passwords from their Hudu account, optionally filtered by various criteria such as archived status, company association, name, slug, search query, and update date ranges.

Common scenarios for this node include:

  • Fetching a list of asset passwords for auditing or reporting purposes.
  • Integrating asset password data into other workflows or systems.
  • Filtering asset passwords based on specific attributes like company or update time to monitor changes or compliance.

For example, a user might use this node to get all asset passwords updated in the last 7 days for a particular company, then pass that data to another system for further processing or alerting.

Properties

Name Meaning
Return All Boolean option to return all matching results or limit the number of results returned.
Limit When "Return All" is false, limits the maximum number of results returned (minimum 1, default 25).
Filters Collection of filters to narrow down the asset passwords retrieved:
  Archived Boolean filter to show only archived asset passwords.
  Company Name or ID Select a company from a dropdown list or specify an ID via expression to filter asset passwords belonging to that company.
  Name Filter asset passwords by their name (string match).
  Search General search query string to filter asset passwords.
  Slug Filter by URL slug associated with the asset password.
  Updated At Date range filter to retrieve asset passwords updated at an exact date, within a date range, or preset ranges such as "Last 7 Days", "Today", "This Month", etc. Supports specifying start/end dates or selecting presets.

Output

The node outputs an array of JSON objects representing the asset passwords retrieved from the Hudu API. Each object contains the details of an individual asset password matching the specified filters and limits.

  • The output JSON structure corresponds directly to the asset password data returned by the API.
  • If multiple input items are processed, each output item is paired with its corresponding input item index.
  • No binary data output is indicated for 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 API is taken from the credentials configuration.
  • The node relies on internal helper methods to handle API calls and map responses.

Troubleshooting

  • Common issues:
    • Incorrect or missing API key credential will cause authentication failures.
    • Using invalid filter values (e.g., non-existent company ID) may result in empty results or API errors.
    • Exceeding API rate limits could cause request failures.
  • Error messages:
    • "The resource \"asset_passwords\" is not known!" indicates a misconfiguration of the resource parameter.
    • Network or authentication errors will typically propagate from the API response.
  • Resolutions:
    • Verify API key and base URL in credentials.
    • Double-check filter values and ensure referenced companies or slugs exist.
    • Use "Return All" cautiously to avoid large data loads and potential timeouts.

Links and References

  • Hudu API Documentation — Official API docs for understanding asset password endpoints and parameters.
  • n8n Expressions — Guide on using expressions to dynamically set property values in n8n nodes.

Discussion