TeamCity REST API Reference 2025.11 Help

Revisions

Represents a list of Revision entities.

Properties

count

The number of Revision objects in this collection.

revision

The list of Revision objects owned by this collection.

failOnMissingRevisions

true if the build should fail when child Revision objects are missing valid version values; false if in this case a build should process latest changes.

Schema

Below, you can find a full schema of this object, in XML and JSON formats. You can choose what fields to submit depending on your current needs. Different methods might expect different fields: the best approach is to request this entity via GET and use the response as a base for the following POST request.

A link to another object implies that you can substitute it with the schema of the linked object, if it is required for your call.

<Revisions count="7" failOnMissingRevisions="true"> <revision>[[[Revision...|revision.html]]]</revision> </Revisions>
{ "count" : 7, "revision" : [ { "vcsBranchName" : "refs/heads/main", "vcs-root-instance" : { "lastVersion" : "6feff116ab9ad0d3af686526a6ff96272620e70f", "vcsRootInternalId" : "599", "commitHookMode" : false, "vcs-root" : { "vcsRootInstances" : "[[[vcs-root-instances...|vcsrootinstances.html]]]", "project" : "[[[project...|project.html]]]", "projectLocator" : "Obsolete", "uuid" : "02308f8f-60f8-4b28-a964-7911ef0159eb", "modificationCheckInterval" : 2, "internalId" : "599", "name" : "MainGitRoot", "vcsName" : "jetbrains.git", "connectionId" : "my-github-connection-id", "id" : "Builders_MainGitRoot", "href" : "/app/rest/vcs-roots/id:Builders_MainGitRoot", "locator" : "id:Builders_MainGitRoot", "properties" : "[[[properties...|properties.html]]]", "repositoryIdStrings" : "[[[items...|items.html]]]" }, "projectLocator" : "projectLocator", "modificationCheckInterval" : 60, "lastVersionInternal" : "6feff116ab9ad0d3af686526a6ff96272620e70f", "name" : "customRootFromConfig", "vcsName" : "jetbrains.git", "vcs-root-id" : "MyProject_CustomRootFromConfig", "id" : "261", "href" : "/app/rest/vcs-root-instances/id:264", "properties" : { "count" : 1, "property" : [ { "inherited" : true, "name" : "name", "type" : "[[[type...|type.html]]]", "value" : "value" } ], "href" : "href" }, "status" : { "current" : "[[[VcsCheckStatus...|vcscheckstatus.html]]]", "previous" : "[[[VcsCheckStatus...|vcscheckstatus.html]]]" }, "repositoryState" : { "count" : 9, "branch" : [ "[[[branchVersion...|branchversion.html]]]" ], "timestamp" : "20250412T151928+0200" }, "repositoryIdStrings" : { "item" : [ "item" ] } }, "checkout-rules" : "+:. => maven-root-repo", "internalVersion" : "version", "version" : "version" } ], "failOnMissingRevisions" : true }
Last modified: 02 December 2025