The /rest/2/addons API includes a REST resource for creating app versions. You might want to do this as part of an automated release process. The manual equivalent would be to go to manage listings on Marketplace, select one of your existing apps, select Create version and fill in the version creation form.
For an example of such a script (using the Bash shell and curl), see create-addon-version.sh in the Marketplace API Tutorials repository.
You will need:
.jar, .obr or workflow file) for the new app versionIf the app is directly installable, you will need to upload the artifact (.jar, .obr or workflow file) to the Marketplace server. You will do this by sending the file data in an HTTP POST to the resource that the Marketplace API provides for this purpose; the URL path for this resource is currently /rest/2/assets/artifact.
Rather than hard-coding the URL path for the resource, you can also obtain it by starting from the entry point of the API. This takes additional steps, but is a better practice in case resource paths ever change in the future.
Do a GET request to https://marketplace.atlassian.com/rest/2--you will receive a JSON response that looks something like this:
1 2{ "_links": { "self": { "href": "/rest/2" }, [some more links...] "assets": { "href": "/rest/2/assets" } } }
The href property under assets is the URL path for the general area of the API that deals with uploading files. Do a GET request to this resource https://marketplace.atlassian.com/rest/2/assets--you will receive a JSON response like this:
1 2{ "_links": { "self": { "href": "/rest/2/assets" }, "artifact": { "href": "/rest/2/assets/artifact" } }
Now, the href property under artifacts gives you the URL path for the resource you'll use to upload your artifact.
POSThttps://marketplace.atlassian.com/rest/2/assets/artifact?file=LOGICAL_FILE_NAME
LOGICAL_FILE_NAME, substitute whatever you want the file to be called when a user downloads it, for instance my-app-1.0.jarapplication/octet-string or leave it unspecifiedExample of sending this request with curl:
1 2$ curl --basic --user MY_USERNAME \ -H "Content-Type: application/octet-stream" \ --data-binary @/LOCATION_OF_MY_FILE/my-app-1.0.jar \ https://marketplace.atlassian.com/rest/2/assets/artifact?file=my-app-1.0.jar
1 2{ "_links": { "self": { "href": "/rest/2/assets/artifact%2F1324354154%2Fmy-app-1.0.jar" } } [...you can ignore the rest of the JSON properties...] }
Copy the value of the self.href property (in this case, "/rest/2/assets/artifact%2F1324354154%2Fmy-app-1.0.jar"); you will need it in the next step.
Here is an example of a JSON document with some of the properties you will normally want to specify:
1 2{ "_links": { "artifact": { "href": "/rest/2/assets/artifact%2F1324354154%2Fmy-app-1.0.jar" } }, "name": "1.0", "buildNumber": 100, "status": "private", "paymentModel": "free", "compatibilities": [ { "application": "jira", "server": { "min": { "build": 70107 }, "max": { "build": 71003 } } } ], "release": { "date": "2016-03-17", "beta": false, "supported": false }, "text": { "releaseSummary": "here is a new version" }, "vendorLinks": { } }
/_links/artifact:
href property here should be set to the same value that you received in the upload response._links.artifact.href to the URL of the artifact (for instance, "http://my-server.com/url/to/download/my-app-1.0.jar") so Marketplace knows where to find it._links.artifact entirely./name: the version string. You can omit this if it is a directly installable app with a .jar or .obr file, since Marketplace can read the version string from the file./buildNumber: build numbers are unique values you choose to determine version ordering./status: A version can be private or public./paymentModel: A version can be free ("free"), paid via vendor ("vendor"), or paid via Atlassian ("atlassian")./compatibilities: You can entirely omit this property if the new app version has the same Atlassian application compatibility as the previous app version. Otherwise, you will need to specify the application key and (for server apps) the minimum and maximum application build numbers./release/date: This date will appear in the app's version history./release/beta: Set to true if this is a beta version./release/supported: Set to true if this version is officially supported./text/releaseSummary: A brief description of the release.Finally, you'll post the new version to Marketplace. The URL path for this resource is currently /rest/2/addons/ADDON_KEY/versions.
Rather than hard-coding the URL path for the resource, you can also obtain it by starting from the entry point of the API. This takes additional steps, but is a better practice in case resource paths ever change in the future.
Do a GET request to https://marketplace.atlassian.com/rest/2--you will receive a JSON response that looks something like this:
1 2{ "_links": { "self": { "href": "/rest/2" }, [some more links...] "addons": { "href": "/rest/2/addons" } } }
The href property under addons is the URL path of the resource for finding apps. Do a GET request to this resource, with ?limit=0 added to indicate that you don't actually want a full list of apps (https://marketplace.atlassian.com/rest/2/addons?limit=0)--you will receive a JSON response like this:
1 2{ "_links": { "self": { "href": "/rest/2/addons" }, [...some more links that you can ignore...] "byKey": { "href": "/rest/2/addons/{addonKey}", "templated": true } }
Take the href property under byKey, and substitute the app key of your existing app for {addonKey} (for instance, /rest/2/addons/my.excellent.app). Do a GET request to the resulting URL path, resulting in a JSON response like this:
1 2{ "_links": { "self": { "href": "/rest/2/addons/my.excellent.app" }, "versions": { "href": "/rest/2/addons/my.excellent.app/versions" } }
Now, the href property under versions gives you the URL path for the resource you'll use to create the version.
HTTP method: POST
URL: https://marketplace.atlassian.com/rest/2/addons/ADDON_KEY/versions
For ADDON_KEY, substitute the app key of your existing app
Authentication: Basic Authentication, with the username and password of your Atlassian Account
Content type: application/json
Request body: the JSON document from step 2
Example of sending this request with curl:
1 2$ curl --basic --user MY_USERNAME \ -H "Content-Type: application/json" \ --data-binary @/path/to/my-json-document.json \ https://marketplace.atlassian.com/rest/2/addons/my.excellent.app/versions
If successful, you will receive an HTTP 201 status with no response body. The response will have a Location header whose value is the URL path of the newly created version resource (which you can do a GET request to if you want to see the current properties of the version on the server), such as this:
1 2Location: /rest/2/addons/my.excellent.app/versions/build/100
If the properties you specified for the version were invalid or it could not be created for any other reason, you will instead receive an HTTP 400 status with a JSON error document like this:
1 2{ "errors": [ { "path": "/buildNumber", "message": "Must be unique" } ] }
Atlassian may need to approve the new version of your app if you are creating a public version. For example, approval is required if the app was previously using a different payment model or hosting option. See App approval guidelines for more information.
Rate this page: