The REST API documentation (https://docs.atlassian.com/bamboo/REST) could use come revision and improvements to be more in like with existing Atlasssian Documentation.

For example the landing page has limited explanation as to what is being presented and some of the REST examples the "expand" field will not contain any information.