Last updated Nov 10, 2023

Update product links with REST API

You update links by scheduling jobs. Every job represents a separate link update that updates all existing and compatible links found in the product you chose to update. If you later migrate more data into this product, you can schedule another job to update links included in this data.

You can run as many jobs as you need, the already updated links will be omitted.

Before you begin

Here are some prerequisites:

Federated instances

To update links between federated instances, you’ll need to use an additional parameter. We’ve prepared a separate page that describes this case only. Learn how to update links to federated instances


Your requests will be authenticated via HTTP basic auth by using your personal API token. You need to attach the following header to each request:

Authorization: Basic $BASE64_TOKEN

The $BASE64_TOKEN is a base64 encoded string that consists of your email address and API token, like in the following snippet:


That’s a standard basic auth header. You can generate it by using, for example, curl:


To schedule a job, use the following request:

curl \
  -H 'Content-Type: application/json' \
  -XPOST "${SITE_ID}/jobs/cma" \
  --data "$REQUEST_BODY"

Request body

productThe cloud product that has links you want to update: Jira or Confluence. The default is Jira.
productURLThe URL of the cloud product that has links you want to update.
destinationURLThe URL of the cloud product that will be a new destination for links. We’ll update existing links to this URL. It can be a different cloud product (remote links) or the same as the one you’re updating (local links).
migratedFromThe Base URL of the Server or Data Center instance from which you migrated data to the destination product represented by destinationURL.
migratedFromOverride(Optional) If you migrated from a staging or backup instance, provide the Base URL of the corresponding production instance so we can properly map the links. If you migrated from a production instance, skip this parameter.
createBackupWhen set to true, we’ll create a backup of your Jira Cloud instance before updating links. The default is false. Available only for Jira Cloud.

Example request body

    "product":               "jira",
    "productURL":            "",
    "destinationURL":        "",
    "migratedFrom":          "",
    "migratedFromOverride":  "",
    "createBackup":          "true"

Example full request

export YOUR_API_TOKEN=21Iv4we2ZtoLixXX21OUQiF06a
export SITE_ID=b436336f-99ce-2fbc-4520-7301132h1674
export REQUEST_BODY="{
    \"product\":                 \"jira\",
    \"productURL\":              \"\",
    \"destinationURL\":          \"\",
    \"migratedFrom\":            \"\",
    \"migratedFromOverride\":    \"\",
    \"createBackup\":            \"true\"
curl \
  -H 'Content-Type: application/json' \
  -XPOST "${SITE_ID}/jobs/cma" \
  --data "$REQUEST_BODY"

Next steps

Check the status and results

Rate this page: