OpenProjectInstall

Overview

This node interacts with a file storage system to create a new folder within an existing directory structure. Specifically, the "Create Storage Folder" operation under the "File Links" resource allows users to specify a parent folder and create a new subfolder inside it. This is useful for organizing files programmatically in hierarchical storage systems, such as project management tools, cloud storage services, or custom file repositories.

Practical examples include:

• Automatically creating project-specific folders when new projects are initiated.
• Organizing uploaded files into date-based or category-based folders.
• Structuring user-generated content in nested directories for easier access and management.

Properties

Output

The node outputs JSON data representing the newly created folder. This typically includes metadata such as the folder's unique identifier, name, path, creation timestamp, and possibly other attributes returned by the storage API. The output can be used downstream to reference the folder for further operations like uploading files or setting permissions.

No binary data output is indicated for this operation.

Dependencies

• Requires an API key credential to authenticate requests against the target storage or file management service.
• The base URL for the API endpoint must be configured in the node credentials.
• The node depends on an OpenAPI client library to handle communication with the external service.

Troubleshooting

• Common issues:

  • Invalid or missing authentication credentials will cause authorization errors.
  • Providing a non-existent or incorrect parent folder ID will result in errors indicating that the parent folder cannot be found.
  • Naming conflicts if a folder with the same name already exists under the parent may cause the operation to fail or overwrite depending on the API behavior.

• Error messages:

  • Unauthorized / 401: Check that the API key or token is correctly set and has sufficient permissions.
  • Not Found / 404: Verify that the parent folder ID is correct and exists.
  • Conflict / 409: Rename the folder to avoid duplicates or check API documentation for handling duplicates.

Links and References

• Refer to the official API documentation of the storage service you are integrating with for detailed information about folder creation endpoints and error codes.
• n8n documentation on using credentials and HTTP request nodes for custom API integrations.