mittwald icon

mittwald

Interact with mittwald mStudio API

Actions100

Overview

This node operation, App Replace Database, is designed to replace an existing database associated with a specific app installation with a new database. It allows users to specify which old database should be replaced and what new database will take its place, along with the user IDs that should be associated with the new database.

Common scenarios for this node include:

  • Migrating an app's data from one database to another without changing the app installation.
  • Updating database references in an app after a database upgrade or restructuring.
  • Reassigning database users when switching databases for an app.

For example, if you have an app installed that currently uses an outdated database, you can use this operation to seamlessly switch it to a new database while specifying which users should have access to the new database.

Properties

Name Meaning
App Installation Id The ID of the app installation for which the database replacement should occur.
Old Database Id The ID of the database that you want to replace (the current/old database).
New Database Id The ID of the new database that will replace the old one.
Database User Ids A JSON object containing the IDs of the users who should be associated with the new database.

Output

The node outputs JSON data representing the result of the database replacement operation. This typically includes confirmation details such as success status, updated app installation information, or error messages if the operation failed.

No binary data output is indicated by the source code or properties.

Dependencies

  • Requires an API key credential for authentication with the mittwald mStudio API.
  • The node communicates with the mittwald API endpoint at https://api.mittwald.de.
  • Proper configuration of the API key credential within n8n is necessary for successful requests.

Troubleshooting

  • Missing or invalid App Installation Id: Ensure the provided app installation ID exists and is correctly formatted.
  • Incorrect Old or New Database Ids: Verify that both database IDs are valid and accessible.
  • Malformed Database User Ids JSON: The databaseUserIds property expects a valid JSON object; invalid JSON will cause errors.
  • API Authentication Errors: Confirm that the API key credential is set up correctly and has sufficient permissions.
  • Network or API Endpoint Issues: Check connectivity to the mittwald API and ensure the base URL is reachable.

If errors occur, reviewing the exact error message returned by the API can help pinpoint issues such as permission denials, invalid IDs, or malformed requests.

Links and References

Discussion