HumHub icon

HumHub

Consume HumHub API (v.0.1.8)

Actions126

Overview

This node operation uploads files to a specified content container and folder within the HumHub platform. It is useful for automating the process of adding files to HumHub content containers, such as user spaces or groups, directly from n8n workflows. For example, it can be used to upload images, documents, or other binary files to a project folder in HumHub for collaboration or archival purposes.

Use Case Examples

  1. Uploading multiple files from n8n binary data to a specific folder in a HumHub content container.
  2. Automating file uploads to HumHub when new files are added to a cloud storage service.

Properties

Name Meaning
Authentication Method of authentication to use for the API request (Basic Auth or JWT Token).
ID The ID of the content container where files will be uploaded.
Folder ID The ID of the directory (folder) within the content container where files will be uploaded.
Files Collection of files to upload, each specifying the binary property name containing the file data.

Output

JSON

  • id - ID of the uploaded file or files.
  • name - Name of the uploaded file.
  • size - Size of the uploaded file in bytes.
  • mimeType - MIME type of the uploaded file.
  • url - URL or path to access the uploaded file.

Dependencies

  • Requires an API key credential for authentication, either Basic Auth or JWT Token.

Troubleshooting

  • Error 'No binary data exists on item!': This occurs if the input item does not contain any binary data. Ensure that the input data includes binary files before running the node.
    Error 'Binary data property "" does not exist!': This means the specified binary property name for the file is not found in the input item. Verify the binary property name matches the actual binary data property.
  • API request failures: Check that the content container ID and folder ID are correct and that the authentication credentials are valid and have sufficient permissions to upload files.

Links

  • HumHub API Documentation - Official API documentation for HumHub, useful for understanding endpoints and parameters related to file uploads.

Discussion