You are viewing the documentation of TeamCity 10.x and 2017.x, which is not the most recently released version of TeamCity.
View this page in the latest documentation or refer to the listing to choose the documentation corresponding to your TeamCity version.


Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Using a locator in build-related requests, you can filter the builds to be returned in the build-related requests. It is referred to as "build locator" in the scope of REST API.
By default , only excluded are: not-finished, not canceled, not failedToStart not personal builds from default branch are returned. TO return all buildfailed-to-start, personal, on non-default branch in branched build configurations builds. To return all builds, use "defaultFilter:false" dimension.