Interact with Latest Builds
This API is provided for the purpose of accessing latest build information of one or more configurations efficiently.
Access latest build of a specific configuration
Syntax
Latest build information can be accessed by configuration id using http GET method through below url:
http://localhost:8810/rest/latest_builds/<configuration id>
The response is of mime type application/xml, and the content is XML representation of the build. Http status code 204 (no content) will be returned if no any build exists in the configuration.
Please note that only brief information of the build will be returned for efficiency. These brief information includes build id, build version, build status, begin date, build duration, and id of belonging configuration.
Security
You will need to use http BASIC authentication to login as an authorized QuickBuild user if the anonymous does not have permission to access builds of specified configuration.
Demo
Below curl command demostrates how to access XML representation of latest build of configuration with id 2:
curl -u admin:admin http://localhost:8810/rest/latest_builds/2
Get latest builds for all child configurations
Syntax
Latest builds can be queried for all child configurations of specified configuration using http GET method through below url:
http://localhost:8810/rest/latest_builds?parent_configuration_id=<parent configuration id>&recursive=<recursive>
Here <parent configuration id> needs to be replaced with identifier of the parent configuration. QuickBuild will return latest builds of all child configurations of this parent configuration. <recursive> is either true or false , where true means to get latest builds for all child configurations recursively, and false means to get latest builds for all child configurations non-recursively.
The response is of mime type text/plain, and the content is string representation of the build status.
Please note that only brief information of the build will be returned for efficiency. These brief information includes build id, build version, build status, begin date, build duration, and id of belonging configuration.
Security
You will need to use http BASIC authentication to login as an authorized QuickBuild user if the anonymous does not have permission to access builds of any of the child configurations.
Demo
Below curl command demostrates how to access latest builds for all child configurations of root configuration non-recursively:
curl -u admin:admin http://localhost:8810/rest/latest_builds?parent_configuration_id=1&recursive=false