TeamCity REST API Reference 2022.10 Help

Agent

Represents a known agent instance.

Related Help article: Build Agent

Properties

Field

Data type

Allowed values

id

integer

name

string

typeId

integer

connected

boolean

enabled

boolean

authorized

boolean

uptodate

boolean

outdated

boolean

pluginsOutdated

boolean

javaOutdated

boolean

ip

string

protocol

string

  • unidirectional

  • bidirectional

version

string

currentAgentVersion

string

lastActivityTime

string

idleSinceTime

string

disconnectionComment

string

registrationTimestamp

string

host

string

cpuRank

integer

port

integer

href

string

webUrl

string

build

Build

links

Links

enabledInfo

EnabledInfo

authorizedInfo

AuthorizedInfo

properties

Properties

cloudInstance

CloudInstance

cloudImage

CloudImage

environment

Environment

pool

AgentPool

compatibilityPolicy

CompatibilityPolicy

compatibleBuildTypes

BuildTypes

incompatibleBuildTypes

Compatibilities

builds

Builds

locator

string

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.

<agent authorized="true" connected="true" cpuRank="123" currentAgentVersion="string" disconnectionComment="string" enabled="true" host="string" href="string" id="123" idleSinceTime="string" ip="string" javaOutdated="true" lastActivityTime="string" locator="string" name="string" outdated="true" pluginsOutdated="true" port="123" protocol="string" registrationTimestamp="string" typeId="123" uptodate="true" version="string" webUrl="string"> <build 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> <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> <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> </build> <links count="123"> <link>[[[link...|link.html]]]</link> </links> <enabledInfo status="true" statusSwitchTime="string"> <comment>[[[comment...|comment.html]]]</comment> </enabledInfo> <authorizedInfo status="true"> <comment>[[[comment...|comment.html]]]</comment> </authorizedInfo> <properties count="123" href="string"> <property>[[[property...|property.html]]]</property> </properties> <cloudInstance errorMessage="string" href="string" id="string" name="string" networkAddress="string" startDate="string" state="string"> <image>[[[cloudImage...|cloudimage.html]]]</image> <agent>[[[agent...|agent.html]]]</agent> </cloudInstance> <cloudImage agentPoolId="123" agentTypeId="123" errorMessage="string" href="string" id="string" locator="string" name="string" operatingSystemName="string"> <profile>[[[cloudProfile...|cloudprofile.html]]]</profile> <instances>[[[cloudInstances...|cloudinstances.html]]]</instances> </cloudImage> <environment osName="string" osType="string"/> <pool href="string" id="123" locator="string" maxAgents="123" name="string"> <ownerProject>[[[project...|project.html]]]</ownerProject> <projects>[[[projects...|projects.html]]]</projects> <agents>[[[agents...|agents.html]]]</agents> </pool> <compatibilityPolicy policy="string"> <buildTypes>[[[buildTypes...|buildtypes.html]]]</buildTypes> </compatibilityPolicy> <compatibleBuildTypes count="123" href="string" nextHref="string" prevHref="string"> <buildType>[[[buildType...|buildtype.html]]]</buildType> </compatibleBuildTypes> <incompatibleBuildTypes count="123"> <compatibility>[[[compatibility...|compatibility.html]]]</compatibility> </incompatibleBuildTypes> <builds count="123" href="string" nextHref="string" prevHref="string"> <build>[[[build...|build.html]]]</build> </builds> </agent>
{ "disconnectionComment" : "disconnectionComment", "idleSinceTime" : "idleSinceTime", "enabledInfo" : { "statusSwitchTime" : "statusSwitchTime", "comment" : { "text" : "text", "user" : "[[[user...|user.html]]]", "timestamp" : "timestamp" }, "status" : true }, "cpuRank" : 3, "enabled" : true, "compatibleBuildTypes" : { "buildType" : [ "[[[buildType...|buildtype.html]]]" ], "count" : 4, "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" }, "protocol" : "unidirectional", "outdated" : true, "authorized" : true, "host" : "host", "builds" : { "build" : [ { "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" : 2, "state" : "queued", "href" : "href", "detachedFromAgent" : true, "artifacts" : "[[[files...|files.html]]]", "testOccurrences" : "[[[testOccurrences...|testoccurrences.html]]]", "artifactDependencyChanges" : "[[[buildChanges...|buildchanges.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", "modificationId" : "modificationId", "related" : "[[[related...|related.html]]]", "failedToStart" : true, "revisions" : "[[[Revisions...|revisions.html]]]", "delayedByBuild" : "[[[build...|build.html]]]", "queuePosition" : 5, "problemOccurrences" : "[[[problemOccurrences...|problemoccurrences.html]]]", "artifactsDirectory" : "artifactsDirectory", "relatedIssues" : "[[[issuesUsages...|issuesusages.html]]]", "branchName" : "branchName", "startEstimate" : "startEstimate", "downloadedArtifacts" : "[[[downloadedArtifacts...|downloadedartifacts.html]]]", "limitedChangesCount" : 6, "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" : 6, "properties" : "[[[properties...|properties.html]]]", "statistics" : "[[[properties...|properties.html]]]" } ], "count" : 1, "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" }, "links" : { "count" : 6, "link" : [ "[[[link...|link.html]]]" ] }, "id" : 3, "href" : "href", "cloudImage" : { "agentPoolId" : 0, "instances" : "[[[cloudInstances...|cloudinstances.html]]]", "agentTypeId" : 4, "profile" : "[[[cloudProfile...|cloudprofile.html]]]", "name" : "name", "errorMessage" : "errorMessage", "id" : "id", "href" : "href", "operatingSystemName" : "operatingSystemName", "locator" : "locator" }, "authorizedInfo" : { "comment" : { "text" : "text", "user" : "[[[user...|user.html]]]", "timestamp" : "timestamp" }, "status" : true }, "incompatibleBuildTypes" : { "count" : 6, "compatibility" : [ { "compatible" : true, "agent" : "[[[agent...|agent.html]]]", "buildType" : "[[[buildType...|buildtype.html]]]", "unmetRequirements" : "[[[requirements...|requirements.html]]]" } ] }, "uptodate" : true, "ip" : "ip", "pool" : { "projects" : { "count" : 7, "project" : [ "[[[project...|project.html]]]" ], "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" }, "maxAgents" : 0, "ownerProject" : { "virtual" : true, "parentProjectName" : "parentProjectName", "vcsRoots" : { "count" : 1, "vcs-root" : [ "[[[vcs-root...|vcsroot.html]]]" ], "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" }, "projects" : { "count" : 7, "project" : [ "[[[project...|project.html]]]" ], "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" }, "defaultTemplate" : { "template" : "[[[buildType...|buildtype.html]]]", "paused" : true, "description" : "description", "project" : "[[[project...|project.html]]]", "investigations" : "[[[investigations...|investigations.html]]]", "templateFlag" : true, "type" : "regular", "uuid" : "uuid", "projectInternalId" : "projectInternalId", "internalId" : "internalId", "features" : "[[[features...|features.html]]]", "builds" : "[[[builds...|builds.html]]]", "links" : "[[[links...|links.html]]]", "id" : "id", "href" : "href", "settings" : "[[[properties...|properties.html]]]", "vcsRootInstances" : "[[[vcs-root-instances...|vcsrootinstances.html]]]", "templates" : "[[[buildTypes...|buildtypes.html]]]", "artifact-dependencies" : "[[[artifact-dependencies...|artifactdependencies.html]]]", "compatibleAgents" : "[[[agents...|agents.html]]]", "pauseComment" : "[[[comment...|comment.html]]]", "triggers" : "[[[triggers...|triggers.html]]]", "branches" : "[[[branches...|branches.html]]]", "steps" : "[[[steps...|steps.html]]]", "externalStatusAllowed" : true, "agent-requirements" : "[[[agent-requirements...|agentrequirements.html]]]", "webUrl" : "webUrl", "inherited" : true, "snapshot-dependencies" : "[[[snapshot-dependencies...|snapshotdependencies.html]]]", "name" : "name", "vcs-root-entries" : "[[[vcs-root-entries...|vcsrootentries.html]]]", "projectName" : "projectName", "projectId" : "projectId", "parameters" : "[[[properties...|properties.html]]]", "locator" : "locator" }, "description" : "description", "uuid" : "uuid", "parentProjectInternalId" : "parentProjectInternalId", "cloudProfiles" : { "count" : 9, "prevHref" : "prevHref", "href" : "href", "cloudProfile" : [ "[[[cloudProfile...|cloudprofile.html]]]" ], "nextHref" : "nextHref" }, "internalId" : "internalId", "archived" : true, "parentProjectId" : "parentProjectId", "links" : { "count" : 6, "link" : [ "[[[link...|link.html]]]" ] }, "id" : "id", "href" : "href", "parentProject" : { "virtual" : true, "parentProjectName" : "parentProjectName", "vcsRoots" : "[[[vcs-roots...|vcsroots.html]]]", "projects" : "[[[projects...|projects.html]]]", "defaultTemplate" : "[[[buildType...|buildtype.html]]]", "description" : "description", "uuid" : "uuid", "parentProjectInternalId" : "parentProjectInternalId", "cloudProfiles" : "[[[cloudProfiles...|cloudprofiles.html]]]", "internalId" : "internalId", "archived" : true, "parentProjectId" : "parentProjectId", "links" : "[[[links...|links.html]]]", "id" : "id", "href" : "href", "parentProject" : "[[[project...|project.html]]]", "templates" : "[[[buildTypes...|buildtypes.html]]]", "readOnlyUI" : "[[[StateField...|statefield.html]]]", "webUrl" : "webUrl", "buildTypes" : "[[[buildTypes...|buildtypes.html]]]", "name" : "name", "ancestorProjects" : "[[[projects...|projects.html]]]", "parameters" : "[[[properties...|properties.html]]]", "projectFeatures" : "[[[projectFeatures...|projectfeatures.html]]]", "locator" : "locator" }, "templates" : { "buildType" : [ "[[[buildType...|buildtype.html]]]" ], "count" : 4, "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" }, "readOnlyUI" : { "inherited" : true, "value" : true }, "webUrl" : "webUrl", "buildTypes" : { "buildType" : [ "[[[buildType...|buildtype.html]]]" ], "count" : 4, "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" }, "name" : "name", "ancestorProjects" : { "count" : 7, "project" : [ "[[[project...|project.html]]]" ], "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" }, "parameters" : { "count" : 6, "property" : [ { "inherited" : true, "name" : "name", "type" : "[[[type...|type.html]]]", "value" : "value" } ], "href" : "href" }, "projectFeatures" : { "projectFeature" : [ "[[[projectFeature...|projectfeature.html]]]" ], "count" : 4, "href" : "href" }, "locator" : "locator" }, "name" : "name", "id" : 9, "href" : "href", "locator" : "locator", "agents" : { "agent" : [ "[[[agent...|agent.html]]]" ], "count" : 2, "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" } }, "cloudInstance" : { "image" : { "agentPoolId" : 0, "instances" : "[[[cloudInstances...|cloudinstances.html]]]", "agentTypeId" : 4, "profile" : "[[[cloudProfile...|cloudprofile.html]]]", "name" : "name", "errorMessage" : "errorMessage", "id" : "id", "href" : "href", "operatingSystemName" : "operatingSystemName", "locator" : "locator" }, "agent" : { "disconnectionComment" : "disconnectionComment", "idleSinceTime" : "idleSinceTime", "enabledInfo" : "[[[enabledInfo...|enabledinfo.html]]]", "cpuRank" : 4, "enabled" : true, "compatibleBuildTypes" : "[[[buildTypes...|buildtypes.html]]]", "protocol" : "unidirectional", "outdated" : true, "authorized" : true, "host" : "host", "builds" : "[[[builds...|builds.html]]]", "links" : "[[[links...|links.html]]]", "id" : 0, "href" : "href", "cloudImage" : "[[[cloudImage...|cloudimage.html]]]", "authorizedInfo" : "[[[authorizedInfo...|authorizedinfo.html]]]", "incompatibleBuildTypes" : "[[[compatibilities...|compatibilities.html]]]", "uptodate" : true, "ip" : "ip", "pool" : "[[[agentPool...|agentpool.html]]]", "cloudInstance" : "[[[cloudInstance...|cloudinstance.html]]]", "version" : "version", "connected" : true, "currentAgentVersion" : "currentAgentVersion", "compatibilityPolicy" : "[[[compatibilityPolicy...|compatibilitypolicy.html]]]", "registrationTimestamp" : "registrationTimestamp", "environment" : "[[[environment...|environment.html]]]", "pluginsOutdated" : true, "port" : 2, "build" : "[[[build...|build.html]]]", "webUrl" : "webUrl", "name" : "name", "typeId" : 7, "lastActivityTime" : "lastActivityTime", "locator" : "locator", "properties" : "[[[properties...|properties.html]]]", "javaOutdated" : true }, "name" : "name", "errorMessage" : "errorMessage", "id" : "id", "state" : "state", "href" : "href", "networkAddress" : "networkAddress", "startDate" : "startDate" }, "version" : "version", "connected" : true, "currentAgentVersion" : "currentAgentVersion", "compatibilityPolicy" : { "buildTypes" : { "buildType" : [ "[[[buildType...|buildtype.html]]]" ], "count" : 4, "prevHref" : "prevHref", "href" : "href", "nextHref" : "nextHref" }, "policy" : "policy" }, "registrationTimestamp" : "registrationTimestamp", "environment" : { "osType" : "osType", "osName" : "osName" }, "pluginsOutdated" : true, "port" : 8, "build" : { "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" : 2, "state" : "queued", "href" : "href", "detachedFromAgent" : true, "artifacts" : "[[[files...|files.html]]]", "testOccurrences" : "[[[testOccurrences...|testoccurrences.html]]]", "artifactDependencyChanges" : "[[[buildChanges...|buildchanges.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", "modificationId" : "modificationId", "related" : "[[[related...|related.html]]]", "failedToStart" : true, "revisions" : "[[[Revisions...|revisions.html]]]", "delayedByBuild" : "[[[build...|build.html]]]", "queuePosition" : 5, "problemOccurrences" : "[[[problemOccurrences...|problemoccurrences.html]]]", "artifactsDirectory" : "artifactsDirectory", "relatedIssues" : "[[[issuesUsages...|issuesusages.html]]]", "branchName" : "branchName", "startEstimate" : "startEstimate", "downloadedArtifacts" : "[[[downloadedArtifacts...|downloadedartifacts.html]]]", "limitedChangesCount" : 6, "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" : 6, "properties" : "[[[properties...|properties.html]]]", "statistics" : "[[[properties...|properties.html]]]" }, "webUrl" : "webUrl", "name" : "name", "typeId" : 2, "lastActivityTime" : "lastActivityTime", "locator" : "locator", "properties" : { "count" : 6, "property" : [ { "inherited" : true, "name" : "name", "type" : "[[[type...|type.html]]]", "value" : "value" } ], "href" : "href" }, "javaOutdated" : true }
Last modified: 30 November 2022