List app installations that a user has access to

GET /v2/app-installations/

API version

v2

Request method

GET

Operation ID

app-list-appinstallations-for-user

---

Request

Responses

Format

application/json

Beschreibung

Object containing the list of AppInstallations.

Schema-Dokumentation

• Array[
• *object

  An AppInstallation is a concrete manifestation of an App in a specific AppVersion.

  • appIdstring (uuid)

    required
  • appVersionobject

    required

    VersionStatus describes the current and desired version of something like the AppVersion of an AppInstallation. If diverging, an internal process is going to assert, the current value will be aligned.

    • currentstring
    • desiredstring

      required
  • customDocumentRootstring
  • descriptionstring

    required
  • disabledboolean

    required
  • idstring (uuid)

    required
  • installationPathstring

    required
  • linkedDatabasesarray of object
    • Array[
    • *object

      LinkedDatabase is a reference to a concrete Database and DatabaseUsers.

      • databaseIdstring (uuid)

        required
      • databaseUserIdsobject
        • *string
      • kindstring (one of: mysql, redis)

        required
      • purposestring (one of: primary, cache, custom)

        required
    ]
• processesarray of string (uuid)
  • Array[
  • *string (uuid)
  ]

projectIdstring (uuid)

screenshotIdstring (uuid)

screenshotRefstring

shortIdstring

required

systemSoftwarearray of object

• Array[
• *object

  InstalledSystemSoftware describes the currently configured and installed SystemSoftwareVersion of a SystemSoftware besides the desired SystemSoftwareUpdatePolicy inside an AppInstallation.

  • systemSoftwareIdstring (uuid)

    required
  • systemSoftwareVersionobject

    required

    VersionStatus describes the current and desired version of something like the AppVersion of an AppInstallation. If diverging, an internal process is going to assert, the current value will be aligned.

    • currentstring
    • desiredstring

      required
  • updatePolicystring (one of: none, inheritedFromApp, patchLevel, all)

    required

    SystemSoftwareUpdatePolicy describes which updates should be applied automatically by our systems.

]

updatePolicystring (one of: none, patchLevel, all)

AppUpdatePolicy describes which updates should be applied automatically by our systems.

userInputsarray of object

• Array[
• *object

  A SavedUserInput is an entered value for a desired UserInput of an AppVersion or SystemSoftwareVersion.

  • namestring

    required
  • valuestring

    required
]

]

Beispiel

[
  {
    "appId": "f0f86186-0a5a-45b2-aa33-502777496347",
    "appVersion": {
      "current": "string",
      "desired": "string"
    },
    "customDocumentRoot": "string",
    "description": "string",
    "disabled": true,
    "id": "f0f86186-0a5a-45b2-aa33-502777496347",
    "installationPath": "string",
    "linkedDatabases": [
      {
        "databaseId": "f0f86186-0a5a-45b2-aa33-502777496347",
        "databaseUserIds": {
          "string": "string"
        },
        "kind": "mysql",
        "purpose": "primary"
      }
    ],
    "processes": [
      "f0f86186-0a5a-45b2-aa33-502777496347"
    ],
    "projectId": "f0f86186-0a5a-45b2-aa33-502777496347",
    "screenshotId": "f0f86186-0a5a-45b2-aa33-502777496347",
    "screenshotRef": "string",
    "shortId": "a-XXXXXX",
    "systemSoftware": [
      {
        "systemSoftwareId": "f0f86186-0a5a-45b2-aa33-502777496347",
        "systemSoftwareVersion": {
          "current": "string",
          "desired": "string"
        },
        "updatePolicy": "none"
      }
    ],
    "updatePolicy": "none",
    "userInputs": [
      {
        "name": "string",
        "value": "string"
      }
    ]
  }
]

JSON Schema

{
  "items": {
    "description": "An AppInstallation is a concrete manifestation of an App in a specific AppVersion.",
    "properties": {
      "appId": {
        "format": "uuid",
        "type": "string"
      },
      "appVersion": {
        "description": "VersionStatus describes the current and desired version of something like the AppVersion of an AppInstallation. If diverging, an internal process is going to assert, the current value will be aligned.",
        "properties": {
          "current": {
            "type": "string"
          },
          "desired": {
            "type": "string"
          }
        },
        "required": [
          "desired"
        ],
        "type": "object"
      },
      "customDocumentRoot": {
        "type": "string"
      },
      "description": {
        "type": "string"
      },
      "disabled": {
        "default": false,
        "type": "boolean"
      },
      "id": {
        "format": "uuid",
        "type": "string"
      },
      "installationPath": {
        "type": "string"
      },
      "linkedDatabases": {
        "items": {
          "description": "LinkedDatabase is a reference to a concrete Database and DatabaseUsers.",
          "properties": {
            "databaseId": {
              "format": "uuid",
              "type": "string"
            },
            "databaseUserIds": {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            "kind": {
              "enum": [
                "mysql",
                "redis"
              ],
              "type": "string"
            },
            "purpose": {
              "enum": [
                "primary",
                "cache",
                "custom"
              ],
              "type": "string"
            }
          },
          "required": [
            "databaseId",
            "purpose",
            "kind"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "processes": {
        "items": {
          "format": "uuid",
          "type": "string"
        },
        "type": "array"
      },
      "projectId": {
        "format": "uuid",
        "type": "string"
      },
      "screenshotId": {
        "format": "uuid",
        "type": "string"
      },
      "screenshotRef": {
        "type": "string"
      },
      "shortId": {
        "example": "a-XXXXXX",
        "type": "string"
      },
      "systemSoftware": {
        "items": {
          "description": "InstalledSystemSoftware describes the currently configured and installed SystemSoftwareVersion of a SystemSoftware besides the desired SystemSoftwareUpdatePolicy inside an AppInstallation.",
          "properties": {
            "systemSoftwareId": {
              "format": "uuid",
              "type": "string"
            },
            "systemSoftwareVersion": {
              "description": "VersionStatus describes the current and desired version of something like the AppVersion of an AppInstallation. If diverging, an internal process is going to assert, the current value will be aligned.",
              "properties": {
                "current": {
                  "type": "string"
                },
                "desired": {
                  "type": "string"
                }
              },
              "required": [
                "desired"
              ],
              "type": "object"
            },
            "updatePolicy": {
              "description": "SystemSoftwareUpdatePolicy describes which updates should be applied automatically by our systems.",
              "enum": [
                "none",
                "inheritedFromApp",
                "patchLevel",
                "all"
              ],
              "type": "string"
            }
          },
          "required": [
            "systemSoftwareId",
            "updatePolicy",
            "systemSoftwareVersion"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "updatePolicy": {
        "description": "AppUpdatePolicy describes which updates should be applied automatically by our systems.",
        "enum": [
          "none",
          "patchLevel",
          "all"
        ],
        "type": "string"
      },
      "userInputs": {
        "items": {
          "description": "A SavedUserInput is an entered value for a desired UserInput of an AppVersion or SystemSoftwareVersion.",
          "properties": {
            "name": {
              "type": "string"
            },
            "value": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "value"
          ],
          "type": "object"
        },
        "type": "array"
      }
    },
    "required": [
      "id",
      "appId",
      "shortId",
      "appVersion",
      "description",
      "installationPath",
      "disabled"
    ],
    "type": "object"
  },
  "type": "array"
}

Usage examples

cURL

$ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v2/app-installations?limit=50&page=1

JavaScript SDK

import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";
  
const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.app.listAppinstallationsForUser({
  "queryParameters": {
    "limit": 50,
    "page": 1
  }
});

assertStatus(response, 200);
  

PHP SDK

use \Mittwald\ApiClient\Generated\V2\Clients\App\ListAppinstallationsForUser\ListAppinstallationsForUserRequest;
  
$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));

$request = (new ListAppinstallationsForUserRequest())
  ->withLimit(50)
  ->withPage(1);
$response = $client->app()->listAppinstallationsForUser($request);

var_dump($response->getBody();