Installing, Uninstalling, Upgrading and Downgrading Marketplace Apps on Confluence using REST API


アトラシアン コミュニティをご利用ください。


プラットフォームについて: Server と Data Center のみ - この記事は、サーバーおよびデータセンター プラットフォームのアトラシアン製品にのみ適用されます。


Using the Confluence Server/Data Center REST API is useful to the Confluence administrator to automate some tasks.

The Universal Plugin Manager (UPM) has a set of API methods that may be helpful to automate some of the tasks associated to Marketplace Apps (aka Plugins or Addons) administration.

This document describes how to use the REST API to the following tasks:

  • Install a Marketplace App.
  • Uninstall a Marketplace App.
  • Upgrade a Marketplace App.
  • Downgrade a Marketplace App.


The following Sections will show an example of using the UPM REST API to perform a few tasks. You may also want to check the Atlassian Marketplace REST API.

These examples were coded using shell script, but you may port it to your preferred coding language.

Some of the shell commands use jq to parse the output data.

Installing a Marketplace App using the REST API

Here we are installing the Confluence Source Editor version 1.1.0, which is not the latest version.

  1. Download the App .jar/.obr file from the Marketplace.

    curl -k -L -o ${APP_FILE_PATH}
    ls -la ${APP_FILE_PATH}; file ${APP_FILE_PATH}
  2. Get the UPM token, which is necessary on the next step.

    UPM_TOKEN=$(curl -I --user $ADMIN_USRNAME:$ADMIN_PWD -H 'Accept: application/vnd.atl.plugins.installed+json' $CONFLUENCE_BASE_URL'/rest/plugins/1.0/?os_authType=basic' 2>/dev/null | grep 'upm-token' | cut -d " " -f 2 | tr -d '\r')
  3. Install the App.

    curl --user ${ADMIN_USRNAME}:${ADMIN_PWD} -H 'Accept: application/json' ${CONFLUENCE_BASE_URL}'/rest/plugins/1.0/?token='${UPM_TOKEN} -F plugin=@${APP_FILE_PATH}
  4. Check if the App was properly installed.

    APP_NAME="Confluence Source Editor"
    curl --user $ADMIN_USRNAME:$ADMIN_PWD $CONFLUENCE_BASE_URL/rest/plugins/latest/ 2>/dev/null | jq -r '.plugins[] | select(.name | contains("'${APP_NAME}'"))'

Uninstalling a Marketplace App using the REST API

In this example we are uninstalling the same App that was installed in the previous Section.

  1. Get the App key.

    APP_NAME="Confluence Source Editor"
    APP_KEY=$(curl --user $ADMIN_USRNAME:$ADMIN_PWD $CONFLUENCE_BASE_URL/rest/plugins/latest/ 2>/dev/null | jq -r '.plugins[] | select(.name | contains("'${APP_NAME}'")) | "\(.key)"')
  2. Uninstall the App; an HTTP 204 response means it was uninstalled.

    curl -I --user ${ADMIN_USRNAME}:${ADMIN_PWD} -H 'Accept: application/json' -X DELETE ${CONFLUENCE_BASE_URL}'/rest/plugins/1.0/'${APP_KEY}'-key' 2>/dev/null

Upgrading a Marketplace App using the REST API

To upgrade an existing App you may download a more recent version from the Atlassian Marketplace and follow the same procedure described in the Installing a Marketplace App using the REST API Section.

Downgrading a Marketplace App using the REST API

Directly downgrading an App isn't possible, not even from the UPM UI.

In this case you need to follow these steps:

  1. Uninstall the current installed version.
  2. Download an old, target version of the App.
  3. Install the target version of the App.


Confluence Server REST API


Atlassian Marketplace REST API

Universal Plugin Manager について

Atlassian Marketplace

How to get a list of Confluence Apps and their licensing information

How to download Atlassian Marketplace apps through the command line

最終更新日 2021 年 11 月 25 日


Powered by Confluence and Scroll Viewport.