Hudu

Overview

This node interacts with the Hudu REST API to manage various resources, including assets. Specifically, the Asset - Get operation retrieves detailed information about a single asset by its ID. This is useful in scenarios where you need to fetch asset details for documentation, auditing, or integration purposes.

For example, you might use this node to:

• Retrieve an asset's metadata before updating it.
• Fetch asset details to display in a custom dashboard.
• Obtain asset information formatted as Asset Links for use in custom fields within Hudu.

Properties

Output

The node outputs a JSON array containing the retrieved asset data. Each item corresponds to one input item processed.

• If Return As Asset Links is disabled, the output contains the full asset details as returned by the Hudu API.
• If Return As Asset Links is enabled, the output includes an array under the specified output field name (default "assetLinks"), formatted for direct use in Asset Link custom fields that accept either single or multiple values.

The output does not include binary data.

Example output structure when Return As Asset Links is enabled:

{
  "assetLinks": [
    {
      "id": 123,
      "name": "Asset Name",
      "url": "https://hudu.example.com/assets/123"
    }
  ]
}

Otherwise, the output will contain the full asset JSON object as provided by the API.

Dependencies

• Requires an active connection to the Hudu REST API.
• Needs an API key credential configured in n8n for authentication.
• The base URL for the Hudu instance must be set in the credentials.
• No additional external dependencies are required.

Troubleshooting

• Invalid Asset ID: If the provided Asset ID does not exist or is invalid, the node will throw an error indicating the asset was not found. Verify the ID is correct.
• Authentication Errors: Missing or incorrect API key or base URL will cause authentication failures. Ensure credentials are properly configured.
• API Rate Limits: Excessive requests may trigger rate limiting by the Hudu API. Implement retry logic or reduce request frequency.
• Output Formatting Issues: If enabling "Return As Asset Links," ensure the receiving custom field supports the expected format; otherwise, data may not display correctly.

Links and References

• Hudu API Documentation
• n8n Documentation on Credentials
• Using Custom Fields in Hudu