...
Refer to each entity description below for the supported locatorsmost popular locator descriptions.
If in doubt what a specific locator supports, send a request with "$help" as the locator value. In response you will get a textual description of what the locator supports. If a request with invalid locators is sent, the error messages often hint on the error and list supported locator dimensions (only non-experimental ones) when an unknown dimension is detectedas well.
Note: If the value contains the "," symbol, it should be enclosed into parentheses: "(<value>)". The value of a dimension can also be encoded as Base64url and sent as "<dimension>:($base64:<base64-encoded-value>)" instead of "<dimension>:<value>".
Examples
http://teamcity:8111/httpAuth/app/rest/projects
gets you the list of projectshttp://teamcity:8111/httpAuth/app/rest/projects/<projectsLocator>
- http://teamcity:8111/httpAuth/app/rest/projects/id:RESTAPIPlugin
(the example id is used) gets you the full data for the REST API Plugin project.
http://teamcity:8111/httpAuth/app/rest/buildTypes/id:bt284/builds?locator=<buildLocator> - http://teamcity:8111/httpAuth/app/rest/buildTypes/id:bt284/builds?locator=status:SUCCESS,tag:EAP
- (example ids are used) to get builds
http://teamcity:8111/httpAuth/app/rest/builds/?locator=<buildLocator>
- to get builds by build locator.
...
Note that editing via the TeamCity Web UI will ve disabled for projects created via the REST API
Base64url