JIRA SOAP API is waving goodbye

May 8th 2015 Dave Meyer in Jira

Remember February 2013? Pope Benedict XVI resigned, Beyoncé performed at the Super Bowl, and Atlassian announced that JIRA's SOAP and XML-RPC APIs would be deprecated in JIRA 6.0. Fast-forward two years and we're approaching the next major milestone in our journey: the SOAP and XML-RPC API modules will be removed from JIRA Cloud soon and in the 7.0 release of JIRA Server.

First, the good news. If you haven't migrated from SOAP to REST yet, we've prepared a method-by-method migration guide to jumpstart your development.

Here are the key details:

  • JIRA 7.0 will ship without the SOAP and XML-RPC APIs
  • The JIRA REST API will have functional parity with SOAP
  • JIRA's rpc-soap and rpc-xmlrpc modules will be removed
  • JIRA will not ship with the rpc-jira-plugin

Why did we do this?

Our original reasoning from February 2013 remains true:

Deprecating SOAP and XML-RPC means that developers have a clear and consistent message from us about how they should be interacting with JIRA remotely. They won't build up code relying on SOAP and then be disappointed when new features don't get added or bugs don't get fixed. No false hope and no bullshit: REST is the future.

We've invested in adding functionality to the JIRA REST API while making it more usable and performant for developers. Atlassian has also introduced the Atlassian Connect framework, which has even more building blocks for rich, functional add-ons for JIRA that are scalable and cross-platform.

What's next?

We know that many customers have written integrations with the SOAP API, or are using third-party add-ons that are built on top of the API. The JIRA Ecosystem team is committed to helping JIRA customers and add-on developers move to REST. We have prepared a SOAP to REST migration guide documenting the existing SOAP methods and our recommended REST equivalents.

We strongly encourage you to collaborate with us if you need help, need to report a bug, or have a feature request for the JIRA Ecosystem team. Simply create an issue in the ACJIRA project on ecosystem.atlassian.net.

All the new 7.0 REST APIs will become available with the first EAP release of JIRA 7.0 Server and in JIRA Cloud in the next couple months. We will post another update here once this ships.