Optional
accountThe account ID for identifying users in the sub
claim sent in JWT during calls. This is the user associated with
the relevant action, and may not be present if there is no logged in user.
URL prefix for this Atlassian product instance. All of its REST endpoints begin with this baseUrl
.
Optional
clientIdentifying key for the Atlassian product tenant that the app was installed into. This will never change for an Atlassian product tenant. However, be aware that importing data into a site will result in a new tenant. In this case, any app installations into the new tenant (using the same baseUrl as the previous tenant) will result in an installation payload containing a different clientKey. Determining the contract between the instance and app in this situation is tracked by AC-1528 in the Connect backlog.
Optional
descriptionThe host product description - this is customisable by an instance administrator.
Optional
displayIf the Atlassian product instance has an associated custom domain, this is the URL through which users will access the product. Any links which an app renders server-side should use this as the prefix of the link. This ensures links are rendered in the same context as the remainder of the user's site.
This field may not be present, in which case the baseUrl value should be used. API requests from your App should always use the baseUrl value and not be based on the URL specified here.
Optional
keyApp key that was installed into the Atlassian Product, as it appears in your app's descriptor.
Optional
oauthThe OAuth 2.0 client ID for your app. For more information, see OAuth 2.0 - JWT Bearer token authorization grant type
Optional
pluginsThis is a SemVer-compliant version of Atlassian Connect which is running on the
host server, for example: 1.1.15
.
Optional
productIdentifies the category of Atlassian product, e.g. jira
or confluence
.
Optional
publicThis is the public key for this Atlassian product instance. This field is deprecated and should not be used.
Optional
serverThis is a string representation of the host product's version. Generally you should not need it.
Optional
serviceAlso known as the SEN, the service entitlement number is the app license ID. This attribute will only be included during installation of a paid app.
Optional
sharedUse this string to sign outgoing JWT tokens and validate incoming JWT tokens. Optional: and may not be present on
non-JWT app installations, and is only sent on the installed
event. All instances of your app use the same shared
secret.
Generated using TypeDoc v0.25.12
Allows an app to register callbacks for events that occur in the lifecycle of an installation. When a lifecycle event is fired, a POST request will be made to the appropriate URL registered for the event.
The installed lifecycle callback is an integral part of the installation process of an app, whereas the remaining lifecycle events are essentially webhooks.
Each property in this object is a URL relative to the app's base URL.