BuildChange

Represents links to the next or previous build.

Properties

Field	Data type
`nextBuild`	`Build`
`prevBuild`	`Build`

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.

<buildChange>
  <nextBuild artifactsDirectory="string" branchName="string" buildTypeId="string" buildTypeInternalId="string" chainModificationId="string" changesCollectingInProgress="true" composite="true" currentSettingsHash="string" customized="true" defaultBranch="true" detachedFromAgent="true" failedToStart="true" finishDate="string" finishEstimate="string" finishOnAgentDate="string" history="true" href="string" id="123456789" limitedChangesCount="123" locator="string" modificationId="string" number="string" percentageComplete="123" personal="true" pinned="true" queuePosition="123" queuedDate="string" running="true" settingsHash="string" startDate="string" startEstimate="string" state="string" status="string" statusText="string" taskId="123456789" unspecifiedBranch="true" usedByOtherBuilds="true" waitReason="string" webUrl="string">
    <links>[[[links...|links.html]]]</links>
    <buildType>[[[buildType...|buildtype.html]]]</buildType>
    <comment>[[[comment...|comment.html]]]</comment>
    <tags>[[[tags...|tags.html]]]</tags>
    <pinInfo>[[[comment...|comment.html]]]</pinInfo>
    <user>[[[user...|user.html]]]</user>
    <delayedByBuild>[[[build...|build.html]]]</delayedByBuild>
    <plannedAgent>[[[agent...|agent.html]]]</plannedAgent>
    <approvalInfo>[[[approvalInfo...|approvalinfo.html]]]</approvalInfo>
    <running-info>[[[progress-info...|progressinfo.html]]]</running-info>
    <canceledInfo>[[[comment...|comment.html]]]</canceledInfo>
    <triggered>[[[TriggeredBy...|triggeredby.html]]]</triggered>
    <lastChanges>[[[changes...|changes.html]]]</lastChanges>
    <changes>[[[changes...|changes.html]]]</changes>
    <revisions>[[[Revisions...|revisions.html]]]</revisions>
    <versionedSettingsRevision>[[[Revision...|revision.html]]]</versionedSettingsRevision>
    <artifactDependencyChanges>[[[buildChanges...|buildchanges.html]]]</artifactDependencyChanges>
    <agent>[[[agent...|agent.html]]]</agent>
    <compatibleAgents>[[[agents...|agents.html]]]</compatibleAgents>
    <compatibleCloudImages>[[[cloudImages...|cloudimages.html]]]</compatibleCloudImages>
    <testOccurrences>[[[testOccurrences...|testoccurrences.html]]]</testOccurrences>
    <problemOccurrences>[[[problemOccurrences...|problemoccurrences.html]]]</problemOccurrences>
    <artifacts>[[[files...|files.html]]]</artifacts>
    <relatedIssues>[[[issuesUsages...|issuesusages.html]]]</relatedIssues>
    <properties>[[[properties...|properties.html]]]</properties>
    <resultingProperties>[[[properties...|properties.html]]]</resultingProperties>
    <originalProperties>[[[properties...|properties.html]]]</originalProperties>
    <startProperties>[[[properties...|properties.html]]]</startProperties>
    <attributes>[[[entries...|entries.html]]]</attributes>
    <statistics>[[[properties...|properties.html]]]</statistics>
    <metadata>[[[datas...|datas.html]]]</metadata>
    <snapshot-dependencies>[[[builds...|builds.html]]]</snapshot-dependencies>
    <artifact-dependencies>[[[builds...|builds.html]]]</artifact-dependencies>
    <custom-artifact-dependencies>[[[artifact-dependencies...|artifactdependencies.html]]]</custom-artifact-dependencies>
    <replacementIds>[[[items...|items.html]]]</replacementIds>
    <related>[[[related...|related.html]]]</related>
    <triggeringOptions>[[[buildTriggeringOptions...|buildtriggeringoptions.html]]]</triggeringOptions>
    <statusChangeComment>[[[comment...|comment.html]]]</statusChangeComment>
    <vcsLabels>[[[vcsLabel...|vcslabel.html]]]</vcsLabels>
    <customization>[[[customizations...|customizations.html]]]</customization>
    <queuedWaitReasons>[[[properties...|properties.html]]]</queuedWaitReasons>
    <downloadedArtifacts>[[[downloadedArtifacts...|downloadedartifacts.html]]]</downloadedArtifacts>
    <firstBuildWithSameChanges>[[[build...|build.html]]]</firstBuildWithSameChanges>
  </nextBuild>
  <prevBuild artifactsDirectory="string" branchName="string" buildTypeId="string" buildTypeInternalId="string" chainModificationId="string" changesCollectingInProgress="true" composite="true" currentSettingsHash="string" customized="true" defaultBranch="true" detachedFromAgent="true" failedToStart="true" finishDate="string" finishEstimate="string" finishOnAgentDate="string" history="true" href="string" id="123456789" limitedChangesCount="123" locator="string" modificationId="string" number="string" percentageComplete="123" personal="true" pinned="true" queuePosition="123" queuedDate="string" running="true" settingsHash="string" startDate="string" startEstimate="string" state="string" status="string" statusText="string" taskId="123456789" unspecifiedBranch="true" usedByOtherBuilds="true" waitReason="string" webUrl="string">
    <links>[[[links...|links.html]]]</links>
    <buildType>[[[buildType...|buildtype.html]]]</buildType>
    <comment>[[[comment...|comment.html]]]</comment>
    <tags>[[[tags...|tags.html]]]</tags>
    <pinInfo>[[[comment...|comment.html]]]</pinInfo>
    <user>[[[user...|user.html]]]</user>
    <delayedByBuild>[[[build...|build.html]]]</delayedByBuild>
    <plannedAgent>[[[agent...|agent.html]]]</plannedAgent>
    <approvalInfo>[[[approvalInfo...|approvalinfo.html]]]</approvalInfo>
    <running-info>[[[progress-info...|progressinfo.html]]]</running-info>
    <canceledInfo>[[[comment...|comment.html]]]</canceledInfo>
    <triggered>[[[TriggeredBy...|triggeredby.html]]]</triggered>
    <lastChanges>[[[changes...|changes.html]]]</lastChanges>
    <changes>[[[changes...|changes.html]]]</changes>
    <revisions>[[[Revisions...|revisions.html]]]</revisions>
    <versionedSettingsRevision>[[[Revision...|revision.html]]]</versionedSettingsRevision>
    <artifactDependencyChanges>[[[buildChanges...|buildchanges.html]]]</artifactDependencyChanges>
    <agent>[[[agent...|agent.html]]]</agent>
    <compatibleAgents>[[[agents...|agents.html]]]</compatibleAgents>
    <compatibleCloudImages>[[[cloudImages...|cloudimages.html]]]</compatibleCloudImages>
    <testOccurrences>[[[testOccurrences...|testoccurrences.html]]]</testOccurrences>
    <problemOccurrences>[[[problemOccurrences...|problemoccurrences.html]]]</problemOccurrences>
    <artifacts>[[[files...|files.html]]]</artifacts>
    <relatedIssues>[[[issuesUsages...|issuesusages.html]]]</relatedIssues>
    <properties>[[[properties...|properties.html]]]</properties>
    <resultingProperties>[[[properties...|properties.html]]]</resultingProperties>
    <originalProperties>[[[properties...|properties.html]]]</originalProperties>
    <startProperties>[[[properties...|properties.html]]]</startProperties>
    <attributes>[[[entries...|entries.html]]]</attributes>
    <statistics>[[[properties...|properties.html]]]</statistics>
    <metadata>[[[datas...|datas.html]]]</metadata>
    <snapshot-dependencies>[[[builds...|builds.html]]]</snapshot-dependencies>
    <artifact-dependencies>[[[builds...|builds.html]]]</artifact-dependencies>
    <custom-artifact-dependencies>[[[artifact-dependencies...|artifactdependencies.html]]]</custom-artifact-dependencies>
    <replacementIds>[[[items...|items.html]]]</replacementIds>
    <related>[[[related...|related.html]]]</related>
    <triggeringOptions>[[[buildTriggeringOptions...|buildtriggeringoptions.html]]]</triggeringOptions>
    <statusChangeComment>[[[comment...|comment.html]]]</statusChangeComment>
    <vcsLabels>[[[vcsLabel...|vcslabel.html]]]</vcsLabels>
    <customization>[[[customizations...|customizations.html]]]</customization>
    <queuedWaitReasons>[[[properties...|properties.html]]]</queuedWaitReasons>
    <downloadedArtifacts>[[[downloadedArtifacts...|downloadedartifacts.html]]]</downloadedArtifacts>
    <firstBuildWithSameChanges>[[[build...|build.html]]]</firstBuildWithSameChanges>
  </prevBuild>
</buildChange>

{
  "prevBuild" : {
    "agent" : "[[[agent...|agent.html]]]",
    "metadata" : "[[[datas...|datas.html]]]",
    "triggered" : "[[[TriggeredBy...|triggeredby.html]]]",
    "usedByOtherBuilds" : true,
    "settingsHash" : "settingsHash",
    "number" : "number",
    "chainModificationId" : "chainModificationId",
    "changesCollectingInProgress" : true,
    "lastChanges" : "[[[changes...|changes.html]]]",
    "resultingProperties" : "[[[properties...|properties.html]]]",
    "composite" : true,
    "links" : "[[[links...|links.html]]]",
    "id" : 6,
    "state" : "queued",
    "href" : "href",
    "detachedFromAgent" : true,
    "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]]]",
    "running-info" : "[[[progress-info...|progressinfo.html]]]",
    "versionedSettingsRevision" : "[[[Revision...|revision.html]]]",
    "percentageComplete" : 6,
    "webUrl" : "webUrl",
    "buildType" : "[[[buildType...|buildtype.html]]]",
    "triggeringOptions" : "[[[buildTriggeringOptions...|buildtriggeringoptions.html]]]",
    "locator" : "locator",
    "startDate" : "startDate",
    "status" : "status",
    "pinned" : true,
    "customized" : true,
    "approvalInfo" : "[[[approvalInfo...|approvalinfo.html]]]",
    "vcsLabels" : [ "[[[vcsLabel...|vcslabel.html]]]" ],
    "customization" : "[[[customizations...|customizations.html]]]",
    "finishEstimate" : "finishEstimate",
    "changes" : "[[[changes...|changes.html]]]",
    "plannedAgent" : "[[[agent...|agent.html]]]",
    "running" : true,
    "statusChangeComment" : "[[[comment...|comment.html]]]",
    "finishOnAgentDate" : "finishOnAgentDate",
    "buildTypeId" : "buildTypeId",
    "buildTypeInternalId" : "buildTypeInternalId",
    "originalProperties" : "[[[properties...|properties.html]]]",
    "modificationId" : "modificationId",
    "related" : "[[[related...|related.html]]]",
    "failedToStart" : true,
    "revisions" : "[[[Revisions...|revisions.html]]]",
    "delayedByBuild" : "[[[build...|build.html]]]",
    "queuePosition" : 1,
    "problemOccurrences" : "[[[problemOccurrences...|problemoccurrences.html]]]",
    "artifactsDirectory" : "artifactsDirectory",
    "relatedIssues" : "[[[issuesUsages...|issuesusages.html]]]",
    "branchName" : "branchName",
    "startEstimate" : "startEstimate",
    "downloadedArtifacts" : "[[[downloadedArtifacts...|downloadedartifacts.html]]]",
    "limitedChangesCount" : 2,
    "firstBuildWithSameChanges" : "[[[build...|build.html]]]",
    "currentSettingsHash" : "currentSettingsHash",
    "unspecifiedBranch" : true,
    "queuedWaitReasons" : "[[[properties...|properties.html]]]",
    "waitReason" : "waitReason",
    "pinInfo" : "[[[comment...|comment.html]]]",
    "snapshot-dependencies" : "[[[builds...|builds.html]]]",
    "statusText" : "statusText",
    "custom-artifact-dependencies" : "[[[artifact-dependencies...|artifactdependencies.html]]]",
    "comment" : "[[[comment...|comment.html]]]",
    "finishDate" : "finishDate",
    "attributes" : "[[[entries...|entries.html]]]",
    "user" : "[[[user...|user.html]]]",
    "queuedDate" : "queuedDate",
    "taskId" : 3,
    "properties" : "[[[properties...|properties.html]]]",
    "statistics" : "[[[properties...|properties.html]]]"
  },
  "nextBuild" : {
    "agent" : "[[[agent...|agent.html]]]",
    "metadata" : "[[[datas...|datas.html]]]",
    "triggered" : "[[[TriggeredBy...|triggeredby.html]]]",
    "usedByOtherBuilds" : true,
    "settingsHash" : "settingsHash",
    "number" : "number",
    "chainModificationId" : "chainModificationId",
    "changesCollectingInProgress" : true,
    "lastChanges" : "[[[changes...|changes.html]]]",
    "resultingProperties" : "[[[properties...|properties.html]]]",
    "composite" : true,
    "links" : "[[[links...|links.html]]]",
    "id" : 6,
    "state" : "queued",
    "href" : "href",
    "detachedFromAgent" : true,
    "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]]]",
    "running-info" : "[[[progress-info...|progressinfo.html]]]",
    "versionedSettingsRevision" : "[[[Revision...|revision.html]]]",
    "percentageComplete" : 6,
    "webUrl" : "webUrl",
    "buildType" : "[[[buildType...|buildtype.html]]]",
    "triggeringOptions" : "[[[buildTriggeringOptions...|buildtriggeringoptions.html]]]",
    "locator" : "locator",
    "startDate" : "startDate",
    "status" : "status",
    "pinned" : true,
    "customized" : true,
    "approvalInfo" : "[[[approvalInfo...|approvalinfo.html]]]",
    "vcsLabels" : [ "[[[vcsLabel...|vcslabel.html]]]" ],
    "customization" : "[[[customizations...|customizations.html]]]",
    "finishEstimate" : "finishEstimate",
    "changes" : "[[[changes...|changes.html]]]",
    "plannedAgent" : "[[[agent...|agent.html]]]",
    "running" : true,
    "statusChangeComment" : "[[[comment...|comment.html]]]",
    "finishOnAgentDate" : "finishOnAgentDate",
    "buildTypeId" : "buildTypeId",
    "buildTypeInternalId" : "buildTypeInternalId",
    "originalProperties" : "[[[properties...|properties.html]]]",
    "modificationId" : "modificationId",
    "related" : "[[[related...|related.html]]]",
    "failedToStart" : true,
    "revisions" : "[[[Revisions...|revisions.html]]]",
    "delayedByBuild" : "[[[build...|build.html]]]",
    "queuePosition" : 1,
    "problemOccurrences" : "[[[problemOccurrences...|problemoccurrences.html]]]",
    "artifactsDirectory" : "artifactsDirectory",
    "relatedIssues" : "[[[issuesUsages...|issuesusages.html]]]",
    "branchName" : "branchName",
    "startEstimate" : "startEstimate",
    "downloadedArtifacts" : "[[[downloadedArtifacts...|downloadedartifacts.html]]]",
    "limitedChangesCount" : 2,
    "firstBuildWithSameChanges" : "[[[build...|build.html]]]",
    "currentSettingsHash" : "currentSettingsHash",
    "unspecifiedBranch" : true,
    "queuedWaitReasons" : "[[[properties...|properties.html]]]",
    "waitReason" : "waitReason",
    "pinInfo" : "[[[comment...|comment.html]]]",
    "snapshot-dependencies" : "[[[builds...|builds.html]]]",
    "statusText" : "statusText",
    "custom-artifact-dependencies" : "[[[artifact-dependencies...|artifactdependencies.html]]]",
    "comment" : "[[[comment...|comment.html]]]",
    "finishDate" : "finishDate",
    "attributes" : "[[[entries...|entries.html]]]",
    "user" : "[[[user...|user.html]]]",
    "queuedDate" : "queuedDate",
    "taskId" : 3,
    "properties" : "[[[properties...|properties.html]]]",
    "statistics" : "[[[properties...|properties.html]]]"
  }
}

Last modified: 22 May 2023