Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Where can I find documentation for Bamboo's remote trigger API?

I just used an Atlassian article to configure my team's integration between BitBucket Cloud and Bamboo Server. I would like to understand the API better, but I can't locate the documentation. Specifically, I want to know:

  • What does the skipBranches flag do?
  • What other parameters are available?

I expected to find it here:



3 answers

1 accepted

2 votes
Answer accepted
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Dec 21, 2017

Hello Jason,

The endpoint is not available in Bamboo's REST API documentation, I am afraid. Now, going back to your inquire:

  • What does the skipBranches flag do?
    By default, the change detection will run for all branches. If this parameter is set to true, the change detection will run only for the chain
  • What other parameters are available?
    planKey and skipBranches are the only parameters available

Kind regards,


0 votes
Przemek Bruski
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Dec 21, 2017

Although we don't generate documentation to that REST endpoint, it's officially supported and should be used for integration. See Rafael's answer for explanation of the parameters.

So, using BitBucket cloud and Bamboo Server 6.2.2 how do I accomplish the following? 

1. PLAN-A - Want to check that the feature branch merges cleanly and do some basic checks.

  • A pull request is opened.
  • Bitbucket sends a trigger to Bamboo with a Web Hook.
  • Bamboo merges the two branches. This is to ensure that the changes merge cleanly. 
  • Some tasks are executed, compile, unit test, etc and the plan completes and is shown on the pull request. 
  • Every time a new change is added to the pull request the web hook is sent and the Bamboo plan repeats the process. 

2. PLAN-B - Merge the change into the target branch(develop) of the pull request and do some more extensive checks before pushing merge back to BitBucket and thus closing the pull request. .

  • A pull request is approved.
  • Bitbucket sends a trigger to Bamboo with a Web Hook.
  • Bamboo merges the feature branch into the target branch of the pull request(develop).
  • Some more extensive checks are done, compile, unit test, integration tests, maybe a deployment to an environment and some smoke tests.
  • On success the merge is pushed back to BitBucket which closes pull request.

This seems like it should be a pretty straight forward process. BUT....

I configured a webhook for PLAN-A which is sent on pull request creation and updates. 


In PLAN-A I set the trigger to be remote. The job is triggered but nothing will be built as the linked repository defaults to develop. So change detection will say there is nothing to do unless I can somehow get a hold of the feature branch.

So I configured PLAN-A to create branches on pull request creation and configured it to use a Branch Updater strategy. 

The trigger is sent, PLAN-A checks for changes on the default branch(develop) for the linked repository and does nothing. But a branch is created for PLAN-A. This does detect changes.  This seems to work.

For PLAN-B I create basically the same webhook but only send it when a pull request is approved to PLAN-B.

The same thing will happen with change detection, i.e, it will check if there are changes on the default branch for the linked repository (develop). Let's say there are none. Now the pull request will not be merged into develop :-(

So I then I wanted configure branches for PLAN-B. So I select create branch when pull request is created. OK this basically the same as Plan-A and should work. When the plan is triggered is doesn't do anything if there are no new changes on the develop branch. But it should see that there is a pull request created? Or what? 

Also If I select create branch when pull request is created i cannot use the Gatekeeper branching strategy! It is simply not available!

So I am really trying to figure out how to handle this...

Any suggestions would be appreciated. 

To be honest, it all seems a little hopeless without being able to trigger a plan with at least the branch to check out...

If we could do that then we could at least do some work from the shell with Git. 

0 votes
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Dec 21, 2017

Hi Jason,

I checked with the Bamboo team and it doesn't look like there is any public documentation for the Remote Trigger API as it's not public and isn't meant to be used in API calls at this time as all the publicly documented API calls can be found in the document you linked to.

I would encourage you to go to JAC and create a Suggestion ticket to get this added to the public API and documentation created for it.



Suggest an answer

Log in or Sign up to answer
AUG Leaders

Atlassian Community Events