ChangeStatus
Stores information this change in terms of effects it had on the TeamCity server: the number of failed/cancelled/successful builds, the number of build configurations that have this change in the pending changes list, the number of build problems and failed tests caused by this change, and so on. Fairly expensive to compute.
Properties
successfulBuilds
Returns how many of finishedBuilds finished successfully.
finishedBuilds
The number of finished builds that processed this change, regardless of their final status.
failedBuilds
Returns how many of finishedBuilds failed.
runningBuilds
The number of currently running builds processing this change, regardless of their current build status.
cancelledBuilds
Returns how many of finishedBuilds were cancelled before they finished.
newTestsFailedBuilds
The list of builds that include this change and have new test failures — tests that passed in the previous build but failed after this change was introduced.
compilationErrorBuilds
The list of builds that include this change and failed due to compilation errors.
runningSuccessfullyBuilds
The number of builds that process this change and are currently running with the 'running and failing' status.
pendingBuildTypes
The number of build configurations (build types) that have not yet processed this change and have it in their 'pending changes' list.
totalProblems
The total number of build problems associated with this change, across all build configurations and their builds.
newFailedTests
The total number of new failed tests associated with this change, across all build configurations and their builds.
otherFailedTests
The total number of failed tests associated with this change. This number does not inlcude the number of new test failures.
queuedBuildsCount
The number of currently queued builds whose list of processed changes includes this change.
criticalBuilds
The list of builds that are critically affected by this change — that is, builds that were the first to detect a failure caused by this change.
notCriticalBuilds
The list of builds that include this change and failed, but are not directly attributed to this change as the root cause.
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.
<ChangeStatus cancelledBuilds="1" failedBuilds="1" finishedBuilds="4" newFailedTests="2" otherFailedTests="2" pendingBuildTypes="2" queuedBuildsCount="1" runningBuilds="3" runningSuccessfullyBuilds="1" successfulBuilds="2" totalProblems="2">
<newTestsFailedBuilds count="12" href="/app/rest/builds?locator=buildType:Project_Config&fields=count,href" nextHref="/app/rest/builds?locator=count:200,start:250,state:finished" prevHref="/app/rest/builds?locator=count:50,start:0,state:finished">
<build>[[[build...|build.html]]]</build>
</newTestsFailedBuilds>
<compilationErrorBuilds count="12" href="/app/rest/builds?locator=buildType:Project_Config&fields=count,href" nextHref="/app/rest/builds?locator=count:200,start:250,state:finished" prevHref="/app/rest/builds?locator=count:50,start:0,state:finished">
<build>[[[build...|build.html]]]</build>
</compilationErrorBuilds>
<criticalBuilds count="12" href="/app/rest/builds?locator=buildType:Project_Config&fields=count,href" nextHref="/app/rest/builds?locator=count:200,start:250,state:finished" prevHref="/app/rest/builds?locator=count:50,start:0,state:finished">
<build>[[[build...|build.html]]]</build>
</criticalBuilds>
<notCriticalBuilds count="12" href="/app/rest/builds?locator=buildType:Project_Config&fields=count,href" nextHref="/app/rest/builds?locator=count:200,start:250,state:finished" prevHref="/app/rest/builds?locator=count:50,start:0,state:finished">
<build>[[[build...|build.html]]]</build>
</notCriticalBuilds>
</ChangeStatus>
{
"successfulBuilds" : 2,
"notCriticalBuilds" : {
"build" : [ {
"agent" : "[[[agent...|agent.html]]]",
"metadata" : "[[[datas...|datas.html]]]",
"triggered" : "[[[TriggeredBy...|triggeredby.html]]]",
"usedByOtherBuilds" : true,
"settingsHash" : "a3f5c2e1d8b74906",
"parallelized" : true,
"number" : "54",
"chainModificationId" : "1916",
"changesCollectingInProgress" : false,
"lastChanges" : "[[[changes...|changes.html]]]",
"resultingProperties" : "[[[properties...|properties.html]]]",
"composite" : false,
"executor" : "[[[BuildExecutor...|buildexecutor.html]]]",
"links" : "[[[links...|links.html]]]",
"id" : 8134,
"state" : "queued",
"href" : "/app/rest/builds/id:8006",
"detachedFromAgent" : false,
"compatibleCloudImages" : "[[[cloudImages...|cloudimages.html]]]",
"artifacts" : "[[[files...|files.html]]]",
"testOccurrences" : "[[[testOccurrences...|testoccurrences.html]]]",
"artifactDependencyChanges" : "[[[buildChanges...|buildchanges.html]]]",
"startProperties" : "[[[properties...|properties.html]]]",
"defaultBranch" : true,
"compatibleAgents" : "[[[agents...|agents.html]]]",
"artifact-dependencies" : "[[[builds...|builds.html]]]",
"replacementIds" : "[[[items...|items.html]]]",
"personal" : true,
"history" : true,
"tags" : "[[[tags...|tags.html]]]",
"canceledInfo" : "[[[comment...|comment.html]]]",
"matrixConfiguration" : "[[[MatrixConfiguration...|matrixconfiguration.html]]]",
"running-info" : "[[[progress-info...|progressinfo.html]]]",
"versionedSettingsRevision" : "[[[Revision...|revision.html]]]",
"percentageComplete" : 6,
"webUrl" : "https://example.com/app/rest/builds/id:8006",
"buildType" : "[[[buildType...|buildtype.html]]]",
"triggeringOptions" : "[[[buildTriggeringOptions...|buildtriggeringoptions.html]]]",
"locator" : "id:22011",
"startDate" : "20240408T162559+0200",
"status" : "SUCCESS",
"pinned" : true,
"customized" : true,
"approvalInfo" : "[[[approvalInfo...|approvalinfo.html]]]",
"vcsLabels" : [ "[[[vcsLabel...|vcslabel.html]]]" ],
"customization" : "[[[customizations...|customizations.html]]]",
"finishEstimate" : "20240409T160130+0200",
"changes" : "[[[changes...|changes.html]]]",
"plannedAgent" : "[[[agent...|agent.html]]]",
"running" : true,
"statusChangeComment" : "[[[comment...|comment.html]]]",
"finishOnAgentDate" : "20240408T162702+0200",
"buildTypeId" : "ProjectName_BuildConfName",
"buildTypeInternalId" : "buildTypeInternalId",
"originalProperties" : "[[[properties...|properties.html]]]",
"modificationId" : "1916",
"related" : "[[[related...|related.html]]]",
"failedToStart" : true,
"revisions" : "[[[Revisions...|revisions.html]]]",
"delayedByBuild" : "[[[build...|build.html]]]",
"queuePosition" : 2,
"problemOccurrences" : "[[[problemOccurrences...|problemoccurrences.html]]]",
"anchorBuild" : "[[[build...|build.html]]]",
"artifactsDirectory" : "/Users/John.Doe/.BuildServer/system/artifacts/ProjectName/ConfigName/1337",
"relatedIssues" : "[[[issuesUsages...|issuesusages.html]]]",
"branchName" : "sandbox",
"startEstimate" : "20240409T155123+0200",
"downloadedArtifacts" : "[[[downloadedArtifacts...|downloadedartifacts.html]]]",
"limitedChangesCount" : 3,
"firstBuildWithSameChanges" : "[[[build...|build.html]]]",
"currentSettingsHash" : "a3f5c2e1d8b74906",
"unspecifiedBranch" : false,
"queuedWaitReasons" : "[[[properties...|properties.html]]]",
"waitReason" : "There are no idle compatible agents which can run this build",
"pinInfo" : "[[[comment...|comment.html]]]",
"snapshot-dependencies" : "[[[builds...|builds.html]]]",
"statusText" : "Tests passed: 5, muted: 1",
"custom-artifact-dependencies" : "[[[artifact-dependencies...|artifactdependencies.html]]]",
"comment" : "[[[comment...|comment.html]]]",
"finishDate" : "20240408T162702+0200",
"attributes" : "[[[entries...|entries.html]]]",
"user" : "[[[user...|user.html]]]",
"queuedDate" : "20240408T162059+0200",
"taskId" : 22011,
"properties" : "[[[properties...|properties.html]]]",
"statistics" : "[[[properties...|properties.html]]]"
} ],
"count" : 12,
"prevHref" : "/app/rest/builds?locator=count:50,start:0,state:finished",
"href" : "/app/rest/builds?locator=buildType:Project_Config&fields=count,href",
"nextHref" : "/app/rest/builds?locator=count:200,start:250,state:finished"
},
"criticalBuilds" : {
"build" : [ {
"agent" : "[[[agent...|agent.html]]]",
"metadata" : "[[[datas...|datas.html]]]",
"triggered" : "[[[TriggeredBy...|triggeredby.html]]]",
"usedByOtherBuilds" : true,
"settingsHash" : "a3f5c2e1d8b74906",
"parallelized" : true,
"number" : "54",
"chainModificationId" : "1916",
"changesCollectingInProgress" : false,
"lastChanges" : "[[[changes...|changes.html]]]",
"resultingProperties" : "[[[properties...|properties.html]]]",
"composite" : false,
"executor" : "[[[BuildExecutor...|buildexecutor.html]]]",
"links" : "[[[links...|links.html]]]",
"id" : 8134,
"state" : "queued",
"href" : "/app/rest/builds/id:8006",
"detachedFromAgent" : false,
"compatibleCloudImages" : "[[[cloudImages...|cloudimages.html]]]",
"artifacts" : "[[[files...|files.html]]]",
"testOccurrences" : "[[[testOccurrences...|testoccurrences.html]]]",
"artifactDependencyChanges" : "[[[buildChanges...|buildchanges.html]]]",
"startProperties" : "[[[properties...|properties.html]]]",
"defaultBranch" : true,
"compatibleAgents" : "[[[agents...|agents.html]]]",
"artifact-dependencies" : "[[[builds...|builds.html]]]",
"replacementIds" : "[[[items...|items.html]]]",
"personal" : true,
"history" : true,
"tags" : "[[[tags...|tags.html]]]",
"canceledInfo" : "[[[comment...|comment.html]]]",
"matrixConfiguration" : "[[[MatrixConfiguration...|matrixconfiguration.html]]]",
"running-info" : "[[[progress-info...|progressinfo.html]]]",
"versionedSettingsRevision" : "[[[Revision...|revision.html]]]",
"percentageComplete" : 6,
"webUrl" : "https://example.com/app/rest/builds/id:8006",
"buildType" : "[[[buildType...|buildtype.html]]]",
"triggeringOptions" : "[[[buildTriggeringOptions...|buildtriggeringoptions.html]]]",
"locator" : "id:22011",
"startDate" : "20240408T162559+0200",
"status" : "SUCCESS",
"pinned" : true,
"customized" : true,
"approvalInfo" : "[[[approvalInfo...|approvalinfo.html]]]",
"vcsLabels" : [ "[[[vcsLabel...|vcslabel.html]]]" ],
"customization" : "[[[customizations...|customizations.html]]]",
"finishEstimate" : "20240409T160130+0200",
"changes" : "[[[changes...|changes.html]]]",
"plannedAgent" : "[[[agent...|agent.html]]]",
"running" : true,
"statusChangeComment" : "[[[comment...|comment.html]]]",
"finishOnAgentDate" : "20240408T162702+0200",
"buildTypeId" : "ProjectName_BuildConfName",
"buildTypeInternalId" : "buildTypeInternalId",
"originalProperties" : "[[[properties...|properties.html]]]",
"modificationId" : "1916",
"related" : "[[[related...|related.html]]]",
"failedToStart" : true,
"revisions" : "[[[Revisions...|revisions.html]]]",
"delayedByBuild" : "[[[build...|build.html]]]",
"queuePosition" : 2,
"problemOccurrences" : "[[[problemOccurrences...|problemoccurrences.html]]]",
"anchorBuild" : "[[[build...|build.html]]]",
"artifactsDirectory" : "/Users/John.Doe/.BuildServer/system/artifacts/ProjectName/ConfigName/1337",
"relatedIssues" : "[[[issuesUsages...|issuesusages.html]]]",
"branchName" : "sandbox",
"startEstimate" : "20240409T155123+0200",
"downloadedArtifacts" : "[[[downloadedArtifacts...|downloadedartifacts.html]]]",
"limitedChangesCount" : 3,
"firstBuildWithSameChanges" : "[[[build...|build.html]]]",
"currentSettingsHash" : "a3f5c2e1d8b74906",
"unspecifiedBranch" : false,
"queuedWaitReasons" : "[[[properties...|properties.html]]]",
"waitReason" : "There are no idle compatible agents which can run this build",
"pinInfo" : "[[[comment...|comment.html]]]",
"snapshot-dependencies" : "[[[builds...|builds.html]]]",
"statusText" : "Tests passed: 5, muted: 1",
"custom-artifact-dependencies" : "[[[artifact-dependencies...|artifactdependencies.html]]]",
"comment" : "[[[comment...|comment.html]]]",
"finishDate" : "20240408T162702+0200",
"attributes" : "[[[entries...|entries.html]]]",
"user" : "[[[user...|user.html]]]",
"queuedDate" : "20240408T162059+0200",
"taskId" : 22011,
"properties" : "[[[properties...|properties.html]]]",
"statistics" : "[[[properties...|properties.html]]]"
} ],
"count" : 12,
"prevHref" : "/app/rest/builds?locator=count:50,start:0,state:finished",
"href" : "/app/rest/builds?locator=buildType:Project_Config&fields=count,href",
"nextHref" : "/app/rest/builds?locator=count:200,start:250,state:finished"
},
"runningSuccessfullyBuilds" : 1,
"finishedBuilds" : 4,
"queuedBuildsCount" : 1,
"totalProblems" : 2,
"newTestsFailedBuilds" : {
"build" : [ {
"agent" : "[[[agent...|agent.html]]]",
"metadata" : "[[[datas...|datas.html]]]",
"triggered" : "[[[TriggeredBy...|triggeredby.html]]]",
"usedByOtherBuilds" : true,
"settingsHash" : "a3f5c2e1d8b74906",
"parallelized" : true,
"number" : "54",
"chainModificationId" : "1916",
"changesCollectingInProgress" : false,
"lastChanges" : "[[[changes...|changes.html]]]",
"resultingProperties" : "[[[properties...|properties.html]]]",
"composite" : false,
"executor" : "[[[BuildExecutor...|buildexecutor.html]]]",
"links" : "[[[links...|links.html]]]",
"id" : 8134,
"state" : "queued",
"href" : "/app/rest/builds/id:8006",
"detachedFromAgent" : false,
"compatibleCloudImages" : "[[[cloudImages...|cloudimages.html]]]",
"artifacts" : "[[[files...|files.html]]]",
"testOccurrences" : "[[[testOccurrences...|testoccurrences.html]]]",
"artifactDependencyChanges" : "[[[buildChanges...|buildchanges.html]]]",
"startProperties" : "[[[properties...|properties.html]]]",
"defaultBranch" : true,
"compatibleAgents" : "[[[agents...|agents.html]]]",
"artifact-dependencies" : "[[[builds...|builds.html]]]",
"replacementIds" : "[[[items...|items.html]]]",
"personal" : true,
"history" : true,
"tags" : "[[[tags...|tags.html]]]",
"canceledInfo" : "[[[comment...|comment.html]]]",
"matrixConfiguration" : "[[[MatrixConfiguration...|matrixconfiguration.html]]]",
"running-info" : "[[[progress-info...|progressinfo.html]]]",
"versionedSettingsRevision" : "[[[Revision...|revision.html]]]",
"percentageComplete" : 6,
"webUrl" : "https://example.com/app/rest/builds/id:8006",
"buildType" : "[[[buildType...|buildtype.html]]]",
"triggeringOptions" : "[[[buildTriggeringOptions...|buildtriggeringoptions.html]]]",
"locator" : "id:22011",
"startDate" : "20240408T162559+0200",
"status" : "SUCCESS",
"pinned" : true,
"customized" : true,
"approvalInfo" : "[[[approvalInfo...|approvalinfo.html]]]",
"vcsLabels" : [ "[[[vcsLabel...|vcslabel.html]]]" ],
"customization" : "[[[customizations...|customizations.html]]]",
"finishEstimate" : "20240409T160130+0200",
"changes" : "[[[changes...|changes.html]]]",
"plannedAgent" : "[[[agent...|agent.html]]]",
"running" : true,
"statusChangeComment" : "[[[comment...|comment.html]]]",
"finishOnAgentDate" : "20240408T162702+0200",
"buildTypeId" : "ProjectName_BuildConfName",
"buildTypeInternalId" : "buildTypeInternalId",
"originalProperties" : "[[[properties...|properties.html]]]",
"modificationId" : "1916",
"related" : "[[[related...|related.html]]]",
"failedToStart" : true,
"revisions" : "[[[Revisions...|revisions.html]]]",
"delayedByBuild" : "[[[build...|build.html]]]",
"queuePosition" : 2,
"problemOccurrences" : "[[[problemOccurrences...|problemoccurrences.html]]]",
"anchorBuild" : "[[[build...|build.html]]]",
"artifactsDirectory" : "/Users/John.Doe/.BuildServer/system/artifacts/ProjectName/ConfigName/1337",
"relatedIssues" : "[[[issuesUsages...|issuesusages.html]]]",
"branchName" : "sandbox",
"startEstimate" : "20240409T155123+0200",
"downloadedArtifacts" : "[[[downloadedArtifacts...|downloadedartifacts.html]]]",
"limitedChangesCount" : 3,
"firstBuildWithSameChanges" : "[[[build...|build.html]]]",
"currentSettingsHash" : "a3f5c2e1d8b74906",
"unspecifiedBranch" : false,
"queuedWaitReasons" : "[[[properties...|properties.html]]]",
"waitReason" : "There are no idle compatible agents which can run this build",
"pinInfo" : "[[[comment...|comment.html]]]",
"snapshot-dependencies" : "[[[builds...|builds.html]]]",
"statusText" : "Tests passed: 5, muted: 1",
"custom-artifact-dependencies" : "[[[artifact-dependencies...|artifactdependencies.html]]]",
"comment" : "[[[comment...|comment.html]]]",
"finishDate" : "20240408T162702+0200",
"attributes" : "[[[entries...|entries.html]]]",
"user" : "[[[user...|user.html]]]",
"queuedDate" : "20240408T162059+0200",
"taskId" : 22011,
"properties" : "[[[properties...|properties.html]]]",
"statistics" : "[[[properties...|properties.html]]]"
} ],
"count" : 12,
"prevHref" : "/app/rest/builds?locator=count:50,start:0,state:finished",
"href" : "/app/rest/builds?locator=buildType:Project_Config&fields=count,href",
"nextHref" : "/app/rest/builds?locator=count:200,start:250,state:finished"
},
"compilationErrorBuilds" : {
"build" : [ {
"agent" : "[[[agent...|agent.html]]]",
"metadata" : "[[[datas...|datas.html]]]",
"triggered" : "[[[TriggeredBy...|triggeredby.html]]]",
"usedByOtherBuilds" : true,
"settingsHash" : "a3f5c2e1d8b74906",
"parallelized" : true,
"number" : "54",
"chainModificationId" : "1916",
"changesCollectingInProgress" : false,
"lastChanges" : "[[[changes...|changes.html]]]",
"resultingProperties" : "[[[properties...|properties.html]]]",
"composite" : false,
"executor" : "[[[BuildExecutor...|buildexecutor.html]]]",
"links" : "[[[links...|links.html]]]",
"id" : 8134,
"state" : "queued",
"href" : "/app/rest/builds/id:8006",
"detachedFromAgent" : false,
"compatibleCloudImages" : "[[[cloudImages...|cloudimages.html]]]",
"artifacts" : "[[[files...|files.html]]]",
"testOccurrences" : "[[[testOccurrences...|testoccurrences.html]]]",
"artifactDependencyChanges" : "[[[buildChanges...|buildchanges.html]]]",
"startProperties" : "[[[properties...|properties.html]]]",
"defaultBranch" : true,
"compatibleAgents" : "[[[agents...|agents.html]]]",
"artifact-dependencies" : "[[[builds...|builds.html]]]",
"replacementIds" : "[[[items...|items.html]]]",
"personal" : true,
"history" : true,
"tags" : "[[[tags...|tags.html]]]",
"canceledInfo" : "[[[comment...|comment.html]]]",
"matrixConfiguration" : "[[[MatrixConfiguration...|matrixconfiguration.html]]]",
"running-info" : "[[[progress-info...|progressinfo.html]]]",
"versionedSettingsRevision" : "[[[Revision...|revision.html]]]",
"percentageComplete" : 6,
"webUrl" : "https://example.com/app/rest/builds/id:8006",
"buildType" : "[[[buildType...|buildtype.html]]]",
"triggeringOptions" : "[[[buildTriggeringOptions...|buildtriggeringoptions.html]]]",
"locator" : "id:22011",
"startDate" : "20240408T162559+0200",
"status" : "SUCCESS",
"pinned" : true,
"customized" : true,
"approvalInfo" : "[[[approvalInfo...|approvalinfo.html]]]",
"vcsLabels" : [ "[[[vcsLabel...|vcslabel.html]]]" ],
"customization" : "[[[customizations...|customizations.html]]]",
"finishEstimate" : "20240409T160130+0200",
"changes" : "[[[changes...|changes.html]]]",
"plannedAgent" : "[[[agent...|agent.html]]]",
"running" : true,
"statusChangeComment" : "[[[comment...|comment.html]]]",
"finishOnAgentDate" : "20240408T162702+0200",
"buildTypeId" : "ProjectName_BuildConfName",
"buildTypeInternalId" : "buildTypeInternalId",
"originalProperties" : "[[[properties...|properties.html]]]",
"modificationId" : "1916",
"related" : "[[[related...|related.html]]]",
"failedToStart" : true,
"revisions" : "[[[Revisions...|revisions.html]]]",
"delayedByBuild" : "[[[build...|build.html]]]",
"queuePosition" : 2,
"problemOccurrences" : "[[[problemOccurrences...|problemoccurrences.html]]]",
"anchorBuild" : "[[[build...|build.html]]]",
"artifactsDirectory" : "/Users/John.Doe/.BuildServer/system/artifacts/ProjectName/ConfigName/1337",
"relatedIssues" : "[[[issuesUsages...|issuesusages.html]]]",
"branchName" : "sandbox",
"startEstimate" : "20240409T155123+0200",
"downloadedArtifacts" : "[[[downloadedArtifacts...|downloadedartifacts.html]]]",
"limitedChangesCount" : 3,
"firstBuildWithSameChanges" : "[[[build...|build.html]]]",
"currentSettingsHash" : "a3f5c2e1d8b74906",
"unspecifiedBranch" : false,
"queuedWaitReasons" : "[[[properties...|properties.html]]]",
"waitReason" : "There are no idle compatible agents which can run this build",
"pinInfo" : "[[[comment...|comment.html]]]",
"snapshot-dependencies" : "[[[builds...|builds.html]]]",
"statusText" : "Tests passed: 5, muted: 1",
"custom-artifact-dependencies" : "[[[artifact-dependencies...|artifactdependencies.html]]]",
"comment" : "[[[comment...|comment.html]]]",
"finishDate" : "20240408T162702+0200",
"attributes" : "[[[entries...|entries.html]]]",
"user" : "[[[user...|user.html]]]",
"queuedDate" : "20240408T162059+0200",
"taskId" : 22011,
"properties" : "[[[properties...|properties.html]]]",
"statistics" : "[[[properties...|properties.html]]]"
} ],
"count" : 12,
"prevHref" : "/app/rest/builds?locator=count:50,start:0,state:finished",
"href" : "/app/rest/builds?locator=buildType:Project_Config&fields=count,href",
"nextHref" : "/app/rest/builds?locator=count:200,start:250,state:finished"
},
"pendingBuildTypes" : 2,
"newFailedTests" : 2,
"cancelledBuilds" : 1,
"failedBuilds" : 1,
"runningBuilds" : 3,
"otherFailedTests" : 2
}
Last modified: 18 August 2026