mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation "App List Appinstallations" retrieves a list of app installations associated with a specific project. It is useful for scenarios where you need to manage or analyze the deployment of apps within projects, such as auditing installed apps, filtering installations by app IDs, or searching through installation metadata.

Practical examples include:

  • Fetching all app installations for a given project to generate reports.
  • Filtering installations by specific app IDs to monitor usage or updates.
  • Searching installations by terms like description or version to find particular deployments.

Properties

Name Meaning
Project Id The identifier of the project whose app installations you want to list. This is required.
App Ids A JSON array of app IDs to filter the installations by. Only installations of these apps will be returned.
Search Term A string to filter installations by searchable fields: id, shortId, description, appVersion, systemSoftwareVersion.
Limit Maximum number of installations to return in the response.
Skip Number of items to skip in the result set; should be a multiple of limit. Useful for pagination.
Page Page number to display. Functions similarly to skip. If both are set, skip takes precedence.

Output

The node outputs a JSON array of app installation objects matching the query parameters. Each object typically contains details about an individual app installation such as its ID, version, description, and related metadata.

If binary data were involved (not indicated here), it would represent files or attachments related to app installations, but this operation focuses on JSON data only.

Dependencies

  • Requires an API key credential for authentication with the mittwald mStudio API.
  • Connects to the mittwald API endpoint at https://api.mittwald.de.
  • Uses standard HTTP headers for JSON content negotiation.

Troubleshooting

  • Missing or invalid Project Id: Since Project Id is required, omitting it or providing an incorrect value will likely cause errors or empty results.
  • Pagination issues: Setting skip incorrectly (not a multiple of limit) may lead to unexpected paging behavior.
  • API authentication errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Empty results despite valid inputs: Check that the filters (appIds, searchTerm) match existing data.

Links and References

Discussion