Last updated Aug 2, 2019

Rate this page:

JIRA Developer Documentation : JIRA APIs

The JIRA platform provides both Java APIs and REST APIs that you can use to interact with JIRA programmatically. These APIs are common to all JIRA applications.

In addition, JIRA Software and JIRA Service Desk provide APIs for application-specific functionality. For example, the JIRA Software REST API has methods for creating sprints, creating boards, retrieving epics, etc. 

JIRA REST APIs

The JIRA REST APIs are used to interact with JIRA remotely, for example, when building Connect add-ons for JIRA Cloud or configuring webhooks. If you haven't used the JIRA REST APIs before, read this overview: About the JIRA REST APIs.

JIRA Platform REST APIs

DistributionDocumentation
JIRA CloudLatest version
JIRA Server

Latest production version

All versions (including EAPs)

JIRA Software REST APIs

To view the old private JIRA Software REST API (formerly the private JIRA Agile REST API), do either of the following:

However, please note the following regarding the private JIRA Software REST API:

  • *For Connect add-ons: Resources that were marked as private in JIRA Agile REST Scopes are no longer whitelisted. You must migrate to the new public REST API. Note, there is feature parity between the whitelisted private resources and the new public REST resources.*
  • *For P2 add-ons:    The private JIRA Software REST API will remain experimental and may break at any time. You can continue to use the private API, but we recommend that you migrate to the new public REST API.  Note, feature parity does not exist between the private and public REST APIs, and we cannot promise that there will be feature parity in future.*

JIRA Service Desk REST APIs

DistributionDocumentation
JIRA Service Desk Cloud Latest version
JIRA Service Desk Server

Latest version

All versions

Webhooks

Webhooks are user-defined callbacks over HTTP, which are specific to the JIRA REST API. JIRA webhooks allow the JIRA REST API to inform a remote application when changes have occurred, e.g. an issue transition. This saves the application from having to periodically poll JIRA (via the REST API). Learn more...

JIRA Java APIs

The JIRA Java APIs are typically used when building Plugins2 plugins (for JIRA Server). If you haven't used the JIRA Java APIs before, make sure you read the Java API Policy for JIRA.

JIRA Platform Java APIs

DistributionDocumentation
JIRA Server

Latest production version

All versions (including EAPs)

JIRA CloudLatest version

JIRA Software Java API

JIRA Service Desk Java API

To\ use\ the\ Java\ API\ for\ JIRA\ Service\ Desk,\ see\ this development\ note.

Rate this page: