Applications

Apply Application Installation Update

Required scopes: application.installation (Read and Write).

Apply the latest cached manifest to an installed application. Requires manifestHash from a recent GET /update call as an optimistic-locking token. If the cached manifest has changed since, returns 409 with the fresh diff in the response body.

post/applications/installations/{identifier}/update

Request

Path parameters

identifierstring required

Application Identifier. Get via List Applications

Request body

manifestHashstring required

Hash of the manifest version the admin reviewed (from GET /update response). Must match the currently cached version, otherwise the apply request fails with 409.

Example request

{
  "manifestHash": "5536b952d54e0846b6fd69217f6eb7cfdcfba41774732926e1f0c1a158a6e405"
}

Response

Application data

Example response

{
  "data": {
    "identifier": "example-application",
    "name": "Application name",
    "installedBy": {
      "id": 12,
      "username": "john_smith",
      "fullName": "John Smith"
    },
    "description": "Application description",
    "logo": "/resources/images/logo.png",
    "logoUrl": "https://localhost.dev/resources/images/logo.png",
    "agent": {
      "id": 12,
      "username": "john_smith",
      "fullName": "John Smith"
    },
    "baseUrl": "https://localhost.dev",
    "manifestUrl": "https://localhost.dev",
    "createdAt": "2019-09-20T11:34:40+00:00",
    "manifestUpdatedAt": "2019-09-20T11:34:40+00:00",
    "modules": [
      {
        "key": "example-application",
        "type": "module-type",
        "permissions": {
          "user": {
            "value": "restricted",
            "ids": [
              1
            ]
          }
        },
        "authenticationType": "none"
      }
    ],
    "scopes": [
      "project"
    ],
    "permissions": {
      "user": {
        "value": "restricted",
        "ids": [
          1
        ]
      },
      "project": {
        "value": "restricted",
        "ids": [
          1
        ]
      }
    },
    "defaultPermissions": {
      "user": "owner",
      "project": "own"
    },
    "limitReached": true,
    "bundle": {
      "mode": "internal"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.