Overview

This page provides information about an individual release of the Atlassian Command Line Interface (CLI) family of add-ons.
More release notes for additional versions of this product are available on the Release Notes page.

Slide Shows

NEW! We have released a number of educational slide shows covering different topics for the Atlassian CLI.
Atlassian CLI Slide Shows

Release Highlights

Release Date	2020-06-26
Version	9.3
Purpose	All Clients New replacement variables for file information on get and get list actions Find replace - removed deprecated support - see ACLI-917 Retry support for failed actions in a run script Jira, Agile, Service Desk, Tempo New custom field options actions for add, remove, and list New runFromFieldList action More information on getIssue included expanded custom field information exportData support for exporting custom field options exportData support for exporting permissions for a permission scheme Many improvements to permission and permission scheme actions and new runFromPermissionList action Additional parameter support on cloneIssues Copy remote links support on cloneIssue, cloneIssues, cloneProject, and copyIssue actions More detailed information on getIssue especially for fields getProjectTemplateList improvements Allow targetServer parameter to reference configuration entries updateUser now allows setting password (server only) Add project name column to getIssueList action for all output formats Support Jira 8.10 Confluence getSource improvements including find replace support Show login information on getUser (server only) updateUser now allows setting password (server only) Performance improvement for getSpacePermissionList getSource action improvements Allow targetServer parameter to reference configuration entries Support Confluence 7.6 Bitbucket Additional fields on getPullRequest action Expand user fields on various get permission actions Performance improvements for addUserToGroup Bitbucket Cloud New project actions New team actions New branch actions Some refactored list output changes for consistency Allow targetServer parameter to reference configuration entries Bamboo Expiry management actions including setExpiryOptions and runBuildExpiry More replacement variables for queueBuild, getBuild, and runFromBuildList exportDeploymentProject now supports java spec export type in addition to CLI Support Bamboo 7.1 including project level variables Fixes

Also available as a Docker image

Atlassian CLI on Docker Hub
Documentation: Docker Image for CLI

Compatibility

Special Compatibility Notice for Version 9.x

If you are upgrading from 8.x, note that there were some significant changes in 9.0 that will impact your configuration and usage.

See Special Compatibility Notice for CLI Version 9.x.

Compatibility

The Atlassian Command Line Interface (CLI) supports a large range of product releases. The matrix below provides compatibility guidelines based on testing, API compatibility information provided by Atlassian, and community feedback. User's are encourage to help improve compatibility information through discussions and issues. The CLI also works with releases not officially listed here since in many cases it uses remote APIs provided by Atlassian that have been stable for many years. Check previous versions of the CLI for coverage of earlier releases. Users should verify their usage scenarios on new releases. Support normally is limited to minimum releases indicated. Client requires at least Java 8 (1.8) and we test with both Java 8 and 11. In some cases, new actions are only available on later versions of the server - these are often noted in the documentation or in error messages.

To simplify the matrix, we no longer list much older releases even though there is some level of compatibility for these as well. Refer to earlier compatibility notes for information on older releases.

See also Compatibility for overall information on supported Atlassian releases.

CLI Clients and Connectors

9.3 clients require connectors at version 9.1 or higher.
Cloud users usually need to update their clients regularly to address incompatibilities introduced by Atlassian with their daily Cloud updates. We deliver EAP releases to immediately cover any problems.
- Atlassian Cloud Platform Changes Impacting CLI Users

Jira Service Desk releases compatible with corresponding Jira releases.
3rd-party apps - like Tempo for instance: We don't explicitly list application versions, but normally test against a recent release of the app that is compatible with the platform it runs on.
Data Center is normally tested on the supported enterprise release designated by Atlassian.

Script Compatibility Warnings

JSON output changes - ACLI-1438 and ACLI-1453
getIssue action - new project name field added to all output formats - see ACLI-1215
findReplace parameter - no longer supports comma separated values - see ACLI-917
Bitbucket Cloud list action output changes for consistency

Run CLI Apps

Apps install and run on an Atlassian application server.

Atlassian App Compatibility

The Atlassian CLI supports a number of different Atlassian apps like Jira Software, Service Desk, and Confluence Questions. We only test and support the most current maintenance release of the apps available for the respective Atlassian application.

Atlassian Incompatibilities

The CLI clients always try to maintain upward compatibility between releases. However, in some cases this is not possible. Occasionally server differences may cause some compatibility issues.

Issues

Key	Summary	Component/s	T	P	Status	Created

Loading...

Refresh

Release Notes 9.3

Overview

Release Highlights

Compatibility

Issues