Overview

This node operation retrieves multiple folder records from the Hudu system. It supports filtering folders based on various criteria such as child folder status, company association, folder type, company specificity, folder name, and parent folder ID. Users can choose to return all matching folders or limit the number of results. Additionally, results can be wrapped into a single item containing an array of folders and a count, which helps prevent downstream nodes from executing once per folder and potentially hitting rate limits. This operation is useful for scenarios where bulk folder data retrieval is needed, such as syncing folder information, reporting, or batch processing.

Use Case Examples

1. Retrieve all folders associated with a specific company.
2. Get up to 25 photo-type folders that are not child folders.
3. Fetch folders by name filter and wrap results to avoid rate limiting in subsequent nodes.

Properties

Output

JSON

• items - Array of folder objects when results are wrapped.
• count - Number of folder objects returned when results are wrapped.
  - Individual folder properties returned when results are not wrapped.

Dependencies

• Hudu REST API
• API authentication token (credential required)

Troubleshooting

• Ensure the API credentials are correctly configured and have permissions to access folder data.
• If filtering by company, verify the company name or ID is valid and accessible.
• Be cautious with client-side filtering options like 'Child Folder' and 'Parent Folder ID' as they may impact performance.
• If the node throws an error about unknown resource, verify the resource parameter is set to 'folders'.
• Use the 'Wrap Results in Single Item' option to avoid rate limiting issues when processing many folders downstream.