v4

latestOpenAPI 3.0.1Apache 2.02026-08-016079122.3 MB
App properties

Set app property (Forge)

Sets the value of a Forge app's property. These values can be retrieved in Jira expressions through the app context variable. They are also available in entity property display conditions.

For other use cases, use the Storage API.

The value of the request body must be a valid, non-empty JSON blob. The maximum length is 32768 characters.

Permissions required: Only Forge apps can make this request. This API can only be accessed using asApp() requests from Forge.

The new write:app-data:jira OAuth scope is 100% optional now, and not using it won't break your app. However, we recommend adding it to your app's scope list because we will eventually make it mandatory.

put/rest/forge/1/app/properties/{propertyKey}

Path parameters

propertyKeystring required

The key of the property.

Request body

{"stackTrail":"paths:/rest/forge/1/app/properties/{propertyKey}:put:requestBody:content:application/json:schema","oasType":"schema","type":"unknown"}

Response

Returned if the property is updated.

messagestring required

The human-readable message that describes the result.

statusCodeinteger required

The status code of the response.

Example response

{
  "message": "An example message.",
  "statusCode": 200
}