Tips & Tricks

TeamCity build status icon

With the upcoming version of TeamCity 7.1, it is now easier to get status updates on a build, by using TeamCity’s HTTP API . We have had this functionality in the past, however it hasn’t been straightforward to use and not the most ideal solution for things like markup pages.

With 7.1, which is currently in EAP we have simplified this. The following single line of code:

<img src=""/>

produces the status icon for the “rest-clients” project:

The only thing you need to know about the project is the build configuration ID, which is always accessible in the URL address bar

Build Configuration id

If a build is not successful, you’ll see:  or 

The code required is:

<a href="http://teamcity/viewType.html?buildTypeId=btN&guest=1">
<img src="http://teamcity/app/rest/builds/buildType:(id:btN)/statusIcon"/>

Don’t forget to add the “guest=1” parameters to the URL so that people clicking on the link will be taken directly to the build page. Otherwise they’ll be welcomed with a login screen. See it in action on GitHub. For more details about the options available, see the documentation page.

Happy green builds!


image description

Discover more