TeamCity REST API Reference 2023.05 Help

Get Build Configuration Details

This article shows how to get build configuration details via REST API.

List Build Configurations

To get all build configurations on the server, use:

/app/rest/buildTypes

Server will respond with a BuildTypes entity which contains the BuildType entities found by request.

Get Specific Build Configurations

To locate specific build configurations, use:

/app/rest/buildTypes/{buildConfigurationLocator}

where buildConfigurationLocator is a BuildTypeLocator-typed string used to locate the build configuration.

For example, to find a build configuration with the MyBuildConfigurationID ID use:

/app/rest/buildTypes/id:MyBuildConfigurationID

To locate all build configurations explicitly owned by a project with the MyProject ID, use:

/app/rest/buildTypes?locator=project:MyProject

The request above does not return build configurations owned by subprojects of the MyProject project. To obtain all configurations, including those owned by child subprojects, use the following request instead:

/app/rest/buildTypes?locator=affectedProject:<ProjectLocator>
Last modified: 28 August 2023