Skip to main content

Get the missing requirements of an appInstallation for a specific target app version

GET /v2/app-installations/{appInstallationId}/missing-dependencies/
v2
GET
app-get-missing-dependencies-for-appinstallation

Request

  • appInstallationIdstring (uuid)
    required

Responses

application/json

The missing dependencies of the AppInstallation for the target AppVersion.

  • missingSystemSoftwareDependenciesarray of object
    • Array[
    • *object

      A SystemSoftwareDependency is a description of a need for a specific SystemSoftware in a semver versionRange.

      • systemSoftwareIdstring (uuid)
        required
      • versionRangestring
        required
    • ]
  • missingUserInputsarray of object
    • Array[
    • *object

      A UserInput is a description of an information which cannot be determined or estimated by mittwald, but has to be given by the person who is requesting an AppInstallation or SystemSoftware.

      • dataSourcestring

        Optional field to tell the frontend, which data to put into the select.

      • dataTypestring (one of: text, number, boolean, select)
        required

        UserInputDataType is an enum, describing the possible data types of a UserInput.

      • defaultValuestring
      • formatstring (one of: email, password, url, uri)

        UserInputFormat is an enum, describing the possible data formats of a UserInput, the given values can be validated against.

      • lifecycleConstraintstring (one of: installation, update, reconfigure)
        required

        The AppInstallationLifecycle can be used to express a specific point in the AppInstallation Lifecycle, e.g. while installing a new AppInstallation.

      • namestring
        required
      • positionMetaobject

        UserInputPositionMeta is a utility information, helping to position the UserInput properly on the frontend.

        • indexnumber
        • sectionstring
        • stepstring
      • requiredboolean
        required
      • validationSchemastring
        required

        JSON Schema formatted (https://json-schema.org/).

    • ]
  • Usage examples

    $ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v2/app-installations/f0f86186-0a5a-45b2-aa33-502777496347/missing-dependencies?targetAppVersionID=f0f86186-0a5a-45b2-aa33-502777496347