Actions100
- Activity Log Actions
- Article Actions
- Asset Actions
- Asset Layout Actions
- Asset Layout Field Actions
- Asset Password Actions
- Card Actions
- Company Actions
- Expiration Actions
- Folder Actions
- IP Address Actions
- List Actions
- Magic Dash Actions
- Matcher Actions
- Network Actions
- Password Folder Actions
- Procedure Actions
- Procedure Task Actions
- Public Photo Actions
- Rack Storage Actions
- Rack Storage Item Actions
Overview
This node interacts with the Hudu REST API to retrieve multiple folder records based on specified filters and limits. It is useful for scenarios where you need to list or process many folders from Hudu, such as organizing documentation, managing company resources, or syncing folder data with other systems.
For example, you might use this node to:
- Fetch all folders belonging to a specific company.
- Retrieve only top-level folders (non-child folders).
- Limit the number of folders returned for performance reasons.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all matching folder results or limit the output to a specified maximum number. |
| Limit | The maximum number of folder results to return when "Return All" is false. Must be at least 1. |
| Filters | A collection of optional filters to narrow down the folders returned: |
| - Child Folder | Filter folders based on whether they are child folders ("Yes"), not child folders ("No"), or all folders (no filter). Note: This filtering is applied client-side and may impact performance. |
| - Company Name or ID | Select a company by name or specify its ID to filter folders belonging to that company. You can also use expressions to specify the ID dynamically. |
| - In Company | Boolean flag to return only folders specific to a company if no explicit company filter is applied. |
| - Name | Filter folders by their name (string match). |
| - Parent Folder ID | Filter folders by their parent folder's ID. This filtering is also applied client-side and may affect performance. |
Output
The node outputs an array of JSON objects representing folders retrieved from the Hudu API. Each object contains folder details such as IDs, names, company associations, parent folder relationships, and other metadata as provided by the API.
There is no binary data output in this operation.
Dependencies
- Requires an API key credential for authenticating with the Hudu REST API.
- The base URL for the Hudu API must be configured in the node credentials.
- The node relies on internal helper methods to call the Hudu API endpoints related to folders.
Troubleshooting
- Performance issues: Client-side filtering on "Child Folder" and "Parent Folder ID" may slow down execution if many folders are returned before filtering. To improve performance, try to use server-side filters like company or name whenever possible.
- Authentication errors: Ensure the API key credential is valid and has sufficient permissions to access folder data.
- Unknown resource error: If the resource parameter is set incorrectly, the node will throw an error indicating the resource is unknown.
- Limit ignored when Return All is true: When "Return All" is enabled, the "Limit" property is ignored; ensure this is intended behavior.
Links and References
- Hudu API Documentation (for detailed API endpoint info)
- n8n Expressions Documentation (for dynamic parameter usage)