Get Project Details
This article contains use cases related to retrieving project details via TeamCity REST API:
Get a list of projects on a server or details of a specific project.
Get build configurations/templates under a specific project.
Get a list of project features.
List Projects
To get a list of all projects on the server, use:
The server will respond with a Projects entity containing up to 100 recent Project entities.
The endpoint response is paginated. Use nextHref
or prevHref
properties of Projects
to navigate the response pages. Alternatively, you can control which projects are returned with the count
(number of returned projects) and start
(position of the first returned project) dimensions:
In this example, the request will return 10 projects starting from the 15th element in the collection.
Get Project Details
To get a specific project, use:
The projectLocator
parameter is a locator string typed as ProjectLocator. For example, to retrieve a project with the ID MyCustomProject
, use:
The call returns an entity of Project (or an exception if the project has not been found).
List Build Configurations of Project
This call will return a list of nested build configurations of the project found under projectLocator
:
The type of response is BuildTypes.
List Build Templates of Project
This call will return a list of nested build templates of the project found under projectLocator
:
A build template is a special case of a build configuration, so the response type is also BuildTypes.
List Project Features
To get the project features associated with a project, use:
The type of response is ProjectFeatures.
List Ordered Build Configurations and Subprojects
TeamCity allows defining custom ordering for build configurations and subprojects. By default, REST API will return these entities listed in the default order. To retrieve a list of build configurations as they appear in the UI, send:
If there is a custom order defined for the project, the endpoint will return BuildTypes. Otherwise, it will respond with an empty collection.
Similarly, for the list of subprojects, use:
To apply custom ordering, send an ordered list of build configurations to:
Here is an example of payload to update the order of build configurations A
, B
, and C
so that C
appears before B
:
To order subprojects, use: