Greenhopper (JIRA Agile) REST API documentation

I'm looking for any Greenhopper rest api documentation that tells me the available URI's I can interface with to get data out of our system. I can use "jira.com/rest/greenhopper/1.0/rapidview" which seems to work but only found by coming across a blog on the web - is there any official documentation or wiki?

Thanks.

9 answers

1 accepted

9 votes
Andrew Lui Atlassian Team Aug 24, 2015

We're pleased to announce that JIRA Agile now has a public REST API. The new officially supported REST API includes a number of improvements over the old private JIRA Agile REST APIs:

  • New resources — We've added a number of new resources to help you interact with JIRA Agile, like the epic and sprint resources.
  • Online documentation — You don't need to mess around looking at private internal API calls anymore. The documentation is available online and will be updated with each release.
  • New documentation theme — The documentation is now easier to parse with expandable sections for resources and better styling.

Check out the documentation for the latest version here: https://docs.atlassian.com/greenhopper/REST/cloud/ 

If you are currently using the private JIRA Agile REST API, see the instructions below:

  • If you have a Connect add-on — Be aware that the resources that are marked as private in JIRA Agile REST Scopes have been deprecated. These private resources will no longer be whitelisted on the 1st November 2015. You must migrate to the new public REST API before this date. Note, there is feature parity between the whitelisted private resources and the new public REST resources.
  • If you have a P2 add-on — Be aware that the private JIRA Agile 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.

If you have problems using the new JIRA Agile REST API, create an issue in the ACJIRA project on ecosystem.atlassian.net (not the issue tracker shown at the top of this page).

Andrew Lui
Technical writer, JIRA ecosystem 

Hello Andrew, We noticed several changes in the new REST API compared to the previous one, most important change: creation of scrum and kanban boards via the HTTP REST call jira.com/rest/greenhopper/1.0/rapidview, which is now obsolete, and not replaced at all. This feature has been removed. Question: are you aware of any replacement method to create boards, or else, do you expect a new method to appear in the upcoming releases, to replace this missing feature? Luc, for Nuum Solutions

I'm confused by the current documentation, I can't find the sprint documentation easily from the main (?) REST api page: https://docs.atlassian.com/jira/REST/cloud/  

This link may be useful : https://jira.atlassian.com/rest/greenhopper/1.0/application.wadl

Try to wget it, it's a wadl format (same spirit than wsdl!). 

It may not provide any documentation, but if the services have an explicit name, we may understand by ourselves what it's designed for smile

I've run across the same problem. If documentation is going to take awhile (seems to have been in request for over a year now) can we at least get an explanation of how to add a filter? In my case, I just want a specific sprint (our organization's rapid board contains multiple different teams running parallel sprints). If I provide sprint or sprintId or anything else, it still gives me all the sprints on my rapidboard. I see in the response there's an "activeFilters" response, but I've tried putting jql, filter, quickFilter, etc into the request with no success.
If the issues actually had the sprintId in them, I'd be able to use that to determine which sprint I want and get just those, but they don't. It looks like my only option is to combine this with another request (standard JIRA issue api for that given sprint, then loop through those to get my data and combine it with the story info here).
Any thoughts on this?

0 vote

We have a couple of pages available on developer.atlassian.com in particular here and here which could provide you with the information you might be looking for.

Thanks Mick. What I'm really after is this https://docs.atlassian.com/jira/REST/6.1/ but for Greenhopper. You can see from Omar's answer in this blog below that there must be something that tell's him to use 'rest/greenhopper/1.0/sprints/{rapidviewid}' but what? https://answers.atlassian.com/questions/133844/greenhopper-rest-api-listing-all-issues-in-a-sprint

You can browse the API using the REST API Browser and see what is available. It can be accessed on the dev toolbox in your development JIRA. Check the instructions here - https://developer.atlassian.com/display/DOCS/Using+the+REST+API+Browser

In the upper left you select the plugin you want to browse and it lists its API. This isn't documentation, but it will provide you with a list of the URIs and you can try to call them from there.

Regards,

George

Right, but there's no documentation of how to use each resource. So it's back to Inspect Element and read the source

I'm in the same boat as you guys. I'm currently researching how to use the REST API to return this:

http://jira.[MY-DOMAIN].com/secure/RapidBoard.jspa?rapidView=[ID]&quickFilter=[FILTER]

as a JSON object. I can get the RapidBoard data:

http://jira.[MY-DOMAIN].com/rest/greenhopper/1.0/xboard/work/allData/?rapidViewId=[ID]

but not with the quickFilter. Any suggestions would be most helpful, even if I have to dig myself.

0 vote

Which JIRA Agile REST resource are you using to get the same info as RapidBoard? Is it for plan or work board.


From what I understand, RapidBoard comes with our implementation of JIRA. We're currently using JIRA v5 and Greenhopper v6.

Hi there,

There is already an improvement request being tracked to document REST API for Agile here:

https://jira.atlassian.com/browse/GHS-6786

Cheers,

Pietro

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Published May 21, 2018 in Jira Software

How large do you think Jira Software can grow?

Hi Atlassian Community! My name is Shana, and I’m on the Jira Software team. One of the many reasons this Community exists is to connect you to others on similar product journeys or with comparabl...

1,221 views 10 18
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