Install or update an app | Documentation

curl -X PUT https://api.contentful.com/spaces/space_id/environments/environment_id/app_installations/app_definition_id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "parameters": {
    "hello": "world"
  }
}'

{
  "sys": {
    "type": "AppInstallation",
    "appDefinition": {
      "sys": {
        "type": "Link",
        "linkType": "AppDefinition",
        "id": "<app_definition_id>"
      }
    },
    "createdAt": "2025-11-29T04:39:43.000Z",
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "updatedAt": "2025-11-29T04:39:43.000Z",
    "updatedBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "yadj1kx9rmg0"
      }
    },
    "environment": {
      "sys": {
        "type": "Link",
        "linkType": "Environment",
        "id": "staging"
      }
    }
  },
  "parameters": {
    "hello": "world"
  }
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

space_idstringRequired

space_id identifier

environment_idstringRequired

environment_id identifier

app_definition_idstringRequired

app_definition_id identifier

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful