AvantGuard - HuduInstall

Overview

The Get Password Folders operation for the Password Folders resource retrieves a list of password folders from the AvantGuard Hudu system. This node is useful in scenarios where you need to fetch, filter, or paginate through password folder records—such as synchronizing folder structures, auditing access, or integrating with other systems that require knowledge of your password folder organization.

Practical examples:

• Listing all password folders for reporting or inventory purposes.
• Filtering folders by name or company ID to find specific organizational units.
• Paginating through large sets of folders for batch processing.

Properties

Name	Type	Meaning
Additional Query Parameters	collection	Optional set of filters and pagination controls. Contains the following options:
└─ Name	string	Filter folders by their name.
└─ Company Id	number	Filter folders by a specific company ID.
└─ Search	string	Filter folders using a search query (e.g., partial matches).
└─ Page	number	The page number of results to retrieve (for pagination).
└─ Page Size	number	The number of results to return per page (for pagination).

Output

The node outputs a JSON array of password folder objects. Each object typically contains details about a password folder, such as its ID, name, associated company, and possibly other metadata. The exact structure depends on the Hudu API but generally includes:

[
  {
    "id": 123,
    "name": "Finance",
    "company_id": 456,
    // ...other folder properties
  },
  ...
]

• No binary data is output by this operation.

Dependencies

• External Service: Requires access to the AvantGuard Hudu API.
• API Key/Credentials: Needs valid avantguardHuduApi credentials configured in n8n, including the base URL (baseUrl) for the Hudu instance.
• n8n Configuration: Ensure the custom node and its dependencies are installed and properly configured.

Troubleshooting

Common Issues:

• Invalid Credentials: If the API key or base URL is incorrect, authentication errors will occur. Double-check credential settings in n8n.
• Missing Required Fields: If required query parameters are omitted or incorrectly formatted, the API may return errors or empty results.
• Pagination Issues: If Page or Page Size values are out of range, you may receive no results or an error message.

Common Error Messages:

• "401 Unauthorized": Check your API credentials and permissions.
• "404 Not Found": The endpoint or resource does not exist; verify the base URL and resource path.
• "400 Bad Request": One or more query parameters are invalid; review input property values.

Links and References

• Hudu API Documentation
• n8n Documentation: Custom Nodes
• AvantGuard Hudu Integration