How to enable Global Variables REST API in Bamboo
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
Sometimes it is necessary to manage global variables through the REST API.
Solution
Bamboo does have an API for Global variables, which can list, add, update, and remove Global variables. This API is currently considered a "dark feature" meaning that it's not enabled by default.
This feature can be enabled as follows:
Stop Bamboo
Add -Datlassian.darkfeature.bamboo.experimental.rest.admin.enabled=true by following the instructions of Configuring your system properties.
Start Bamboo
With this feature, the following API endpoint will become available:
<bamboo-url>/rest/admin/latest/globalVariables
Function | HTTP Method | Endpoint | Payload |
|---|---|---|---|
List | GET | <bamboo-url>/rest/admin/latest/globalVariables | NONE |
Add | POST | <bamboo-url>/rest/admin/latest/globalVariables | JSON: name (required) value (optional) |
Update | PUT | <bamboo-url>/rest/admin/latest/globalVariables/<variable-id> | JSON: Any of name (optional) value (optional) |
Remove | DELETE | <bamboo-url>/rest/admin/latest/globalVariables/<variable-id> | NONE |
Was this helpful?