Bamboo REST API versioning

[fstr]

Hi, I'm using Bamboo 7.0.4.

I am successfully using the REST API to trigger Bamboo plans and requesting build result information.

https://bamboo.my.tld/bamboo/rest/api/latest/info

The Bamboo developer guide states, that the Bamboo REST API is using a versioning scheme. The version latest will always point to the current version, but the API version can also be provided as an integer.

The API version number is an integer, such as 1 or 2.
The API version is independent of the Bamboo release number.

I quickly went through 1-10, and v1-v10, but none of them worked.

https://bamboo.my.tld/bamboo/rest/api/7/info

The feature to provide a specific version is very important, since the Bamboo instance and the applications that use the REST API are often maintained by separate teams. Additionally, a breaking change would bring down all API integrations if they point to latest and there would be no way to transition without downtime.

Some questions around this:

• Does the "versioning scheme" in the developer guide match the actual implementation?
• What is the current (Bamboo 7.0.4) API version for the REST API?
• Will a release of Bamboo always ship with (some or any) previous versions of the API?

[Gonchik Tsymzhitov]

hi @fstr , 

Regarding the changes, I do support via wrapper from 5 to 7. 

Mostly in practice not big changes in methods, 

I do follow via next url for the double check

https://docs.atlassian.com/atlassian-bamboo/REST/7.2.2/

Cheers,

Gonchik Tsymzhitov