TeamCity 2020.2 Help

BuildApi

getAllBuilds

Get all builds.

Endpoint

/app/rest/builds

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

Builds

getAggregatedBuildStatus

Get the build status of aggregated matching builds.

Endpoint

/app/rest/builds/aggregated/{buildLocator}/status

HTTP method

GET

Parameters

Response

string

getAggregatedBuildStatusIcon

Get the status icon (in specified format) of aggregated matching builds.

Endpoint

/app/rest/builds/aggregated/{buildLocator}/statusIcon{suffix}

HTTP method

GET

Parameters

deleteMultipleBuilds

Delete multiple builds matching the locator.

Endpoint

/app/rest/builds/multiple/{buildLocator}

HTTP method

DELETE

Produces

  • application/xml
  • application/json

Parameters

Response

MultipleOperationResult

getMultipleBuilds

Get multiple builds matching the locator.

Endpoint

/app/rest/builds/multiple/{buildLocator}

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

Builds

deleteMultipleBuildComments

Delete comments of multiple matching builds.

Endpoint

/app/rest/builds/multiple/{buildLocator}/comment

HTTP method

DELETE

Produces

  • application/xml
  • application/json

Parameters

Response

MultipleOperationResult

setMultipleBuildComments

Update comments in multiple matching builds.

Endpoint

/app/rest/builds/multiple/{buildLocator}/comment

HTTP method

PUT

Consumes

  • text/plain

Produces

  • application/xml
  • application/json

Parameters

Response

MultipleOperationResult

pinMultipleBuilds

Pin multiple matching builds.

Endpoint

/app/rest/builds/multiple/{buildLocator}/pinInfo

HTTP method

PUT

Consumes

  • application/xml
  • application/json

Produces

  • application/xml
  • application/json

Parameters

Response

MultipleOperationResult

removeMultipleBuildTags

Remove tags from multiple matching builds.

Endpoint

/app/rest/builds/multiple/{buildLocator}/tags

HTTP method

DELETE

Consumes

  • application/xml
  • application/json

Produces

  • application/xml
  • application/json

Parameters

Response

MultipleOperationResult

addTagsToMultipleBuilds

Add tags to multiple matching builds.

Endpoint

/app/rest/builds/multiple/{buildLocator}/tags

HTTP method

POST

Consumes

  • application/xml
  • application/json

Produces

  • application/xml
  • application/json

Parameters

Response

MultipleOperationResult

deleteBuild

Delete build matching the locator.

Endpoint

/app/rest/builds/{buildLocator}

HTTP method

DELETE

Parameters

getBuild

Get build matching the locator.

Endpoint

/app/rest/builds/{buildLocator}

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

Build

getArtifactDependencyChanges

Get artifact dependency changes of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/artifactDependencyChanges

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

BuildChanges

getFilesListOfBuild

List all files.

Endpoint

/app/rest/builds/{buildLocator}/artifacts

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

  • buildLocator: string <BuildLocator>
  • basePath: string
  • locator: string
  • fields: string
  • resolveParameters: boolean
  • logBuildUsage: boolean

Response

Files

getZippedFileOfBuild

Get specific file zipped.

Endpoint

/app/rest/builds/{buildLocator}/artifacts/archived{path}

HTTP method

GET

Produces

  • */*

Parameters

  • path: string
  • buildLocator: string <BuildLocator>
  • basePath: string
  • locator: string
  • name: string
  • resolveParameters: boolean
  • logBuildUsage: boolean

downloadFileOfBuild

Download specific file.

Endpoint

/app/rest/builds/{buildLocator}/artifacts/files{path}

HTTP method

GET

Produces

  • */*

Parameters

  • path: string
  • buildLocator: string <BuildLocator>
  • resolveParameters: boolean
  • logBuildUsage: boolean

getFileMetadataOfBuild

Get metadata of specific file.

Endpoint

/app/rest/builds/{buildLocator}/artifacts/metadata{path}

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

  • path: string
  • buildLocator: string <BuildLocator>
  • fields: string
  • resolveParameters: boolean
  • logBuildUsage: boolean

Response

file

getFilesListForSubpathOfBuild

List files under this path.

Endpoint

/app/rest/builds/{buildLocator}/artifacts/{path}

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

  • path: string
  • buildLocator: string <BuildLocator>
  • basePath: string
  • locator: string
  • fields: string
  • resolveParameters: boolean
  • logBuildUsage: boolean

Response

Files

getArtifactsDirectory

Get the artifacts' directory of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/artifactsDirectory

HTTP method

GET

Produces

  • text/plain

Parameters

Response

string

resetBuildFinishProperties

Remove build parameters from the matching build.

Endpoint

/app/rest/builds/{buildLocator}/caches/finishProperties

HTTP method

DELETE

Produces

  • application/xml
  • application/json

Parameters

getCanceledInfo

Check if the matching build is canceled.

Endpoint

/app/rest/builds/{buildLocator}/canceledInfo

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

Comment

deleteBuildComment

Remove the build comment matching the locator.

Endpoint

/app/rest/builds/{buildLocator}/comment

HTTP method

DELETE

Parameters

setBuildComment

Update the comment on the matching build.

Endpoint

/app/rest/builds/{buildLocator}/comment

HTTP method

PUT

Consumes

  • text/plain

Parameters

setFinishedTime

Marks the running build as finished by passing agent the current time of the build to finish.

Endpoint

/app/rest/builds/{buildLocator}/finish

HTTP method

PUT

Consumes

  • text/plain

Produces

  • text/plain

Parameters

Response

string

getBuildFinishDate

Get the finish date of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/finishDate

HTTP method

GET

Produces

  • text/plain

Parameters

Response

string

setBuildFinishDate

Marks the running build as finished by passing agent the current time of the build to finish.

Endpoint

/app/rest/builds/{buildLocator}/finishDate

HTTP method

PUT

Consumes

  • text/plain

Produces

  • text/plain

Parameters

Response

string

addLogMessageToBuild

Adds a message to the build log. Service messages are accepted.

Endpoint

/app/rest/builds/{buildLocator}/log

HTTP method

POST

Consumes

  • text/plain

Parameters

getBuildNumber

Get the number of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/number

HTTP method

GET

Produces

  • text/plain

Parameters

Response

string

setBuildNumber

Update the number of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/number

HTTP method

PUT

Consumes

  • text/plain

Produces

  • text/plain

Parameters

Response

string

getBuildPinInfo

Check if the matching build is pinned.

Endpoint

/app/rest/builds/{buildLocator}/pinInfo

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

PinInfo

setBuildPinInfo

Update the pin info of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/pinInfo

HTTP method

PUT

Consumes

  • application/xml
  • application/json

Produces

  • application/xml
  • application/json

Parameters

Response

PinInfo

getBuildProblems

Get build problems of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/problemOccurrences

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

ProblemOccurrences

addProblemToBuild

Add a build problem to the matching build.

Endpoint

/app/rest/builds/{buildLocator}/problemOccurrences

HTTP method

POST

Consumes

  • text/plain

Produces

  • application/xml
  • application/json

Parameters

Response

ProblemOccurrence

getBuildRelatedIssues

Get related issues of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/relatedIssues

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

IssuesUsages

getBuildResolved

Get the resolvement status of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/resolved/{value}

HTTP method

GET

Produces

  • text/plain

Parameters

Response

string

getBuildActualParameters

Get actual build parameters of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/resulting-properties

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

Properties

getBuildResultingProperties

Update a build parameter of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/resulting-properties/{propertyName}

HTTP method

GET

Produces

  • text/plain

Parameters

Response

string

markBuildAsRunning

Starts the queued build as an agent-less build and returns the corresponding running build.

Endpoint

/app/rest/builds/{buildLocator}/runningData

HTTP method

PUT

Consumes

  • text/plain

Produces

  • application/xml
  • application/json

Parameters

Response

Build

getBuildSourceFile

Get a source file of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/sources/files/{fileName}

HTTP method

GET

Produces

  • application/octet-stream

Parameters

getBuildStatisticValues

Get all statistical values of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/statistics

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

Properties

getBuildStatisticValue

Get a statistical value of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/statistics/{name}

HTTP method

GET

Produces

  • text/plain

Parameters

Response

string

getBuildStatusIcon

Get the status icon (in specified format) of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/statusIcon{suffix}

HTTP method

GET

Parameters

getBuildStatusText

Get the build status text of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/statusText

HTTP method

GET

Produces

  • text/plain

Parameters

Response

string

setBuildStatusText

Update the build status of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/statusText

HTTP method

PUT

Consumes

  • text/plain

Produces

  • text/plain

Parameters

Response

string

getBuildTags

Get tags of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/tags

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

Tags

addTagsToBuild

Add tags to the matching build.

Endpoint

/app/rest/builds/{buildLocator}/tags

HTTP method

POST

Consumes

  • application/xml
  • application/json

Produces

  • application/xml
  • application/json

Parameters

Response

Tags

setBuildTags

Update tags of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/tags

HTTP method

PUT

Consumes

  • application/xml
  • application/json

Produces

  • application/xml
  • application/json

Parameters

Response

Tags

getBuildTestOccurrences

Get test occurrences of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/testOccurrences

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

TestOccurrences

getBuildVcsLabels

Get VCS labels of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/vcsLabels

HTTP method

GET

Produces

  • application/xml
  • application/json

Parameters

Response

VcsLabels

addBuildVcsLabel

Add a VCS label to the matching build.

Endpoint

/app/rest/builds/{buildLocator}/vcsLabels

HTTP method

POST

Consumes

  • text/plain

Produces

  • application/xml
  • application/json

Parameters

Response

VcsLabels

getBuildField

Get a field of the matching build.

Endpoint

/app/rest/builds/{buildLocator}/{field}

HTTP method

GET

Produces

  • text/plain

Parameters

Response

string

Last modified: 20 February 2021