Difference between Jira Cloud REST API and Server REST API?

I notice in the documentation that there is docs for a REST API for Jira Cloud, and another set of documentation for the REST API for Jira Server. TL;DR but browsing through the documentation there does not appear to be a lot of obvious difference.

We'd prefer to develop a client that works with both cloud and server. Does anyone know the core differences between these APIs? 

3 answers

1 accepted

1 vote
Accepted answer
Josh Steckler Community Champion Oct 20, 2017

The only difference I saw (on latest versions as of today's date) was mention of Atlassian Connect authentication and development for Cloud. 

Separate docs come from best practice - These are technically different products and features may have different release dates on different platforms and the way those features work is not always going to be the same. Also it's important for Server to use the correct version.

There isn't a significant divergence in the Jira REST API as far as I am aware of right now. But there may be in the future.

There are no major differences in Cloud and Server Rest APIs.
However you should keep your server updated with the latest version so that it has all the new updates and functions as Cloud. 

Older Server versions might have some missing functions and updates. 

Actually, I just found a difference:

If you do 

GET /rest/api/2/filter

on Jira Cloud, you get back a list of all known filters; however, if you do the exact same

GET /rest/api/2/filter

on Jira Server, you get a 405.

Can anyone explain this difference, please?

Josh Steckler Community Champion Feb 01, 2018

Hello Daniel,

We can expect to see the API (and product itself) for cloud vs. server to continue to diverge over time. We can no longer make assumptions that the API will work universally the same.

I'm not quite sure why this specific method on this endpoint doesn't exist on server.

Thanks, Josh.  

Yes, I get that the APIs will diverge over time.  I just wanted to respond to the original post and document what I believe to be a fairly significant difference between the two.  I hope others might find it useful as I was having a hard time investigating this issue.

Josh Steckler Community Champion Feb 01, 2018

Yep. I've found myself looking at the wrong API spec several times. Definitely frustrating sometimes.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Nov 27, 2018 in Portfolio for Jira

Introducing a new planning experience in Portfolio for Jira (Server/DC)

In the past, Portfolio for Jira required a high degree of detail–foresight that was unrealistic for many businesses to   have–in   order to produce a reliable long-term roadmap. We're tur...

2,499 views 15 20
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you