mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node allows users to update (patch) an existing app installation in the mittwald mStudio platform. It is useful for modifying details of an app installation such as its version, description, system software configuration, update policy, and user inputs without needing to recreate the installation from scratch.

Common scenarios include:

  • Updating the app version to a newer release.
  • Changing the custom document root path.
  • Adjusting the update policy to control automatic updates.
  • Modifying system software settings or user input parameters related to the app installation.

For example, a user might want to patch an app installation to switch its update policy from "none" to "patchLevel" so that only patch-level updates are applied automatically.

Properties

Name Meaning
App Installation Id The unique identifier of the app installation to be patched. Required to specify which app installation to update.
App Version Id The identifier of the new app version to apply to the installation.
Custom Document Root A custom path to override the default document root of the app installation.
Description A textual description or notes about the app installation.
System Software JSON object describing the system software configuration associated with the app installation.
Update Policy Defines which updates should be applied automatically by the system. Options: None, Patch Level, All.
User Inputs JSON array containing user-defined input parameters relevant to the app installation.

Output

The node outputs JSON data representing the updated state of the app installation after the patch operation. This typically includes fields reflecting the current configuration and metadata of the app installation as returned by the mittwald API.

There is no indication that the node outputs binary data.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The base URL for API requests is https://api.mittwald.de.
  • The node uses standard HTTP headers for JSON content (Accept: application/json and Content-Type: application/json).

Troubleshooting

  • Missing or invalid App Installation Id: The patch operation requires a valid app installation ID. Ensure this property is set correctly; otherwise, the API will reject the request.
  • Invalid JSON in System Software or User Inputs: These properties expect valid JSON strings. Malformed JSON will cause parsing errors before sending the request.
  • API Authentication Errors: If the API key credential is missing or invalid, authentication will fail. Verify the API key configuration in n8n credentials.
  • Update Policy Value Errors: Only the specified options (none, patchLevel, all) are accepted. Using other values may cause the API to reject the request.
  • Network or API Errors: General connectivity issues or server errors from the mittwald API can occur. Check network connectivity and API status.

Links and References

Discussion