Product events

Rate this page:

Lifecycle events

Forge apps can subscribe to their own lifecycle events for:

Installation

An event with the name avi:forge:installed:app is sent when an app has been installed on a site.

Payload

NameTypeDescription
idstringThe ID of the installation.
installerAccountIdstringThe ID of the user who installed the Forge app.
Use the Get user operation of either Jira and Confluence REST APIs to retrieve more information about the user.
appAppAn object describing the Forge app.

Type reference

1
2
interface App {
  id: string;
  version: string;
}

Example

This is an example payload.

1
2
{
  "id": "fff8e466-31f4-4c73-a337-c3309dd930dc",
  "installerAccountId": "4ad9aa0c52dc1b420a791d12",
  "app": { 
       "id": "406d303d-0393-4ec4-ad7c-1435be94583a", 
       "version": "9.0.0"
    }
}

Upgrade

An event with the name avi:forge:upgraded:app is sent when an installed app on a site has been upgraded.

Payload

NameTypeDescription
idstringThe ID of the installation.
installerAccountIdstringThe ID of the user who upgraded the Forge app.
Use the Get user operation of either Jira and Confluence REST APIs to retrieve more information about the user.
appAppAn object describing the Forge app.

Type reference

1
2
interface App {
  id: string;
  version: string;
}

Example

This is an example payload.

1
2
{
  "id": "fff8e466-31f4-4c73-a337-c3309dd930dc",
  "upgraderAccountId": "4ad9aa0c52dc1b420a791d12",
  "app": { 
       "id": "406d303d-0393-4ec4-ad7c-1435be94583a", 
       "version": "9.0.0"
    }
}

Rate this page: