Related
Contains the list of builds related to the current build through snapshot dependencies. Used as a nested object in Build responses to expose builds that share the same build chain.
Properties
builds
The list of builds related to this build through snapshot dependencies.
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.
<related>
<builds 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>
</builds>
</related>
{
"builds" : {
"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...|]]]",
"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"
}
}
Last modified: 18 August 2026