mittwald icon

mittwald

Interact with mittwald mStudio API

Actions100

Overview

The "Project File System List Files" operation allows users to list or retrieve files within a specified project by interacting with the project's file system. This node is useful for scenarios where you need to programmatically access, monitor, or process files stored in a project environment, such as fetching log files, configuration files, or any other project-related documents.

Practical examples include:

  • Automatically retrieving and processing log files from a project for error analysis.
  • Listing files in a project directory to trigger workflows based on file presence or changes.
  • Accessing specific files to extract data or metadata for further automation.

Properties

Name Meaning
Project Id The unique identifier of the project whose file system you want to access.
File The name or path of the file to retrieve within the project file system (e.g., /home/example.log).

Output

The node outputs JSON data representing the file(s) retrieved or listed from the project file system. The exact structure depends on the API response but typically includes file metadata such as name, size, type, and content if applicable.

If the node supports binary data output (e.g., file contents), it will provide the file data in binary form suitable for further processing or saving.

Dependencies

  • Requires an API key credential to authenticate with the mittwald mStudio API.
  • The node communicates with the mittwald mStudio API endpoint at https://api.mittwald.de.
  • Proper configuration of the API authentication credentials in n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Project Id may result in errors or empty responses.
    • Incorrect file path/name can cause the node to fail to find the file.
    • Authentication failures due to invalid or expired API keys.
    • Network connectivity issues preventing access to the mittwald API.
  • Error messages and resolutions:

    • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly configured and valid.
    • "File not found": Verify the file path and name are correct and that the file exists in the specified project.
    • "Project not found": Confirm the Project Id is accurate and the project exists in the mittwald system.
    • Timeouts or network errors: Ensure stable internet connection and that the API endpoint is reachable.

Links and References

Discussion