mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation allows you to retrieve a file by specifying its unique identifier and name from the mittwald mStudio API. It is useful when you need to programmatically access files stored in the mittwald system, for example, to download user-uploaded documents, images, or other media assets by their known file ID and filename.

Practical scenarios include:

  • Automating backup or synchronization of files from mittwald storage.
  • Fetching specific files for processing or analysis workflows.
  • Integrating file retrieval into larger automation pipelines where files are identified by both ID and name.

Properties

Name Meaning
File Id The unique identifier (UUID) of the file to be retrieved.
File Name The exact name of the file to be retrieved.
Accept The desired response content type. Options: application/octet-stream (binary data), text/plain;base64 (base64 encoded text).
Content Disposition How the file should be presented. Options: inline (display in browser), attachment (download as attachment).
Token Optional token header used for accessing protected files requiring authentication.
accept Query parameter version of the Accept header with same options as above.
content-disposition Query parameter version of the Content Disposition header with same options as above.
token Query parameter version of the Token header for protected files.

Note: Both header and query parameter versions of Accept, Content Disposition, and Token are supported, allowing flexibility depending on API requirements.

Output

The node outputs the retrieved file data in the json field of the output item. Depending on the Accept property chosen:

  • If application/octet-stream is selected, the output will contain the raw binary data of the file.
  • If text/plain;base64 is selected, the output will contain the base64-encoded string representation of the file content.

Binary data handling is implied by the content type but not explicitly detailed in the code snippet.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de.
  • Proper configuration of credentials in n8n is necessary to authorize requests.
  • No additional external dependencies beyond the mittwald API and standard HTTP request capabilities.

Troubleshooting

  • File Not Found: Ensure that the provided File Id and File Name exactly match an existing file in mittwald storage.
  • Authentication Errors: Verify that the API key/token is valid and has permissions to access the requested file, especially if the file is protected.
  • Incorrect Accept Header: Using an unsupported Accept value may cause the API to reject the request or return unexpected data formats.
  • Content Disposition Issues: Setting this incorrectly might affect how the file is handled downstream (e.g., inline display vs forced download).
  • Token Missing for Protected Files: If the file requires a token and none is provided, the request will fail authorization.

Links and References

Discussion