mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node interacts with the "Project File System" resource of the mittwald mStudio API, specifically to list files within a project. It allows users to retrieve file information by specifying a project ID and optionally a file path or name. This is useful for scenarios where you need to programmatically access or monitor files in a project environment, such as fetching logs, configuration files, or other project-related documents.

Practical examples include:

  • Automating retrieval of log files from a specific project for analysis.
  • Listing files in a project directory to trigger further processing or notifications.
  • Integrating project file data into workflows for backup or auditing purposes.

Properties

Name Meaning
Project Id The unique identifier of the project whose files you want to list.
File The name or path of the specific file to retrieve within the project (optional).

Output

The node outputs JSON data representing the files retrieved from the specified project. The structure typically includes metadata about each file such as its name, path, size, modification date, and possibly other attributes depending on the API response.

If binary data is returned (e.g., file contents), it would be included in the output accordingly, but based on the provided code and properties, the primary output is JSON metadata about files.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de to send requests.
  • No additional external dependencies are indicated beyond the API connection.

Troubleshooting

  • Missing or invalid Project Id: Ensure that the Project Id property is correctly set and corresponds to an existing project in mittwald mStudio.
  • File not found errors: If specifying a file path/name, verify that the file exists within the project.
  • Authentication errors: Confirm that the API key credential is valid and has sufficient permissions.
  • Network issues: Check connectivity to https://api.mittwald.de and any firewall settings that might block requests.

Common error messages will likely relate to HTTP status codes such as 401 Unauthorized (authentication failure), 404 Not Found (invalid project or file), or 400 Bad Request (invalid parameters).

Links and References

Discussion