HumHub icon

HumHub

Consume HumHub API (v.0.1.8)

Actions126

Overview

This node operation creates a new directory (folder) within a specified content container in the HumHub platform. It is useful for organizing files and content by creating structured directories programmatically. For example, it can be used to automate the creation of project folders or department-specific directories in a content management system.

Use Case Examples

  1. Create a new directory named 'Project Files' inside a content container with ID 123, targeting directory ID 456, and set it as visible with a description.
  2. Automate folder creation for new clients by specifying container and target directory IDs along with folder details.

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 the directory will be created.
Target ID The ID of the target directory under which the new directory will be created.
Title The name of the new directory to be created.
Folder Additional Fields Additional optional fields for the folder such as description and visibility status.

Output

JSON

  • id - The unique identifier of the created directory.
  • target_id - The ID of the target directory where the new directory was created.
  • Folder
    • title - The title/name of the created directory.
    • description - Description of the created directory.
    • visibility - Visibility status of the directory (public or private).

Dependencies

  • Requires authentication credentials for HumHub API (either Basic Auth or JWT Token).

Troubleshooting

  • Ensure the content container ID and target directory ID are valid and exist in HumHub to avoid errors.
  • The 'visibility' field must be a boolean; invalid values may cause request failures.
  • If the API request fails, check that the authentication credentials are correctly configured and have sufficient permissions.

Links

Discussion