HumHub icon

HumHub

Consume HumHub API (v.0.1.8)

Actions126

Overview

This node operation updates a directory (folder) in the HumHub platform's CFile Directory resource. It allows users to modify properties of an existing directory such as its target directory ID, title, description, and visibility status. This operation is useful for managing file organization within HumHub by updating folder metadata to reflect changes in structure or access permissions.

Use Case Examples

  1. Updating the title and description of a specific directory to better describe its contents.
  2. Changing the visibility of a directory to make it public or private.
  3. Moving a directory to a different target directory by updating its target ID.

Properties

Name Meaning
Authentication Method of authentication to use for the API request, either Basic Auth or JWT Token.
ID The unique identifier of the directory to update.
Target ID The ID of the target directory where the directory should be moved or associated.
Folder Collection of folder properties to update, including title, description, and visibility.

Output

JSON

  • id - The ID of the updated directory.
  • target_id - The ID of the target directory after update.
  • Folder
    • title - The updated title of the folder.
    • Description - The updated description of the folder.
    • visibility - The updated visibility status of the folder (public or private).

Dependencies

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

Troubleshooting

  • Ensure the directory ID provided exists; otherwise, the update will fail with a not found error.
  • Verify that the authentication credentials are correct and have sufficient permissions to update directories.
  • The visibility property must be a boolean; invalid values may cause the request to fail.
  • If the target ID is provided, it must refer to a valid existing directory.

Links

Discussion