AgentPool
An agent pool that is the group of agents with shared permissions and available projects.
Related Help article: Agent Pool
Properties
id
The unique ID of this pool. The Default pool has the ID value of 0.
name
The public name of the pool.
href
Returns the shortened (without the server URL) link to the current pool.
maxAgents
The pool capacity. Returns null for pools with the unlimited number of agent slots.
ownerProject
Returns the corresponding project for project pool. A project pool is an automatically created agent pool for cloud agents spawned from cloud images that belong to this (non-Root) project. These agents can run builds of the corresponding project only.
Regular (non-project) pools return null.
projects
Returns the list of projects assigned to this pool. Pool agents can run builds of these assigned projects only.
Send POST and DELETE requests to the /app/rest/agentPools/{poolLocator}/projects endpoint to change the list of projects assigned to this pool.
agents
The list of agents owned by this pool.
Send POST requests to the /app/rest/agentPools/{agentPoolLocator}/agents endpoint to add agents to the required pool. To remove an agent from the specific pool, add this agent to the Default (id:0) pool.
locator
agentTypes
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.
<agentPool href="/app/rest/agentPools/id:82" id="31" locator="string" maxAgents="10" name="Kubernetes">
<ownerProject archived="false" description="This subproject contains configurations that carry out delivery jobs" href="/app/rest/projects/id:BuildCacheNodeJS" id="BuildCacheNodeJS" internalId="project302" locator="string" name="Build Cache — NodeJS" parentProjectId="S3BucketsTest" parentProjectInternalId="project82" parentProjectName="S3 Buckets Test" uuid="37dccab8-ddf9-4f81-a1ad-7815f0e841e1" virtual="false" webUrl="https://localhost:8111/project.html?projectId=BuildAndDeploy">
<links>[[[links...|links.html]]]</links>
<parentProject>[[[project...|project.html]]]</parentProject>
<readOnlyUI>[[[StateField...|statefield.html]]]</readOnlyUI>
<defaultTemplate>[[[buildType...|buildtype.html]]]</defaultTemplate>
<buildTypes>[[[buildTypes...|buildtypes.html]]]</buildTypes>
<templates>[[[buildTypes...|buildtypes.html]]]</templates>
<deploymentDashboards>[[[deploymentDashboards...|deploymentdashboards.html]]]</deploymentDashboards>
<parameters>[[[properties...|properties.html]]]</parameters>
<vcsRoots>[[[vcs-roots...|vcsroots.html]]]</vcsRoots>
<projectFeatures>[[[projectFeatures...|projectfeatures.html]]]</projectFeatures>
<projects>[[[projects...|projects.html]]]</projects>
<cloudProfiles>[[[cloudProfiles...|cloudprofiles.html]]]</cloudProfiles>
<ancestorProjects>[[[projects...|projects.html]]]</ancestorProjects>
</ownerProject>
<projects count="39" href="/app/rest/projects?locator=count:30,start:10" nextHref="/app/rest/projects?locator=count:30,start:40" prevHref="/app/rest/projects?locator=count:10,start:0">
<project>[[[project...|project.html]]]</project>
</projects>
<agents count="7" href="/app/rest/agents" nextHref="/app/rest/agents?locator=count:200,start:250" prevHref="/app/rest/agents?locator=count:50,start:0">
<agent>[[[agent...|agent.html]]]</agent>
</agents>
<agentTypes count="1" href="/app/rest/agentTypes" nextHref="/app/rest/agentTypes?locator=count:200,start:250" prevHref="/app/rest/agentTypes?locator=count:50,start:0">
<agentType>[[[agentType...|agenttype.html]]]</agentType>
</agentTypes>
</agentPool>
{
"projects" : {
"count" : 39,
"project" : [ "[[[project...|project.html]]]" ],
"prevHref" : "/app/rest/projects?locator=count:10,start:0",
"href" : "/app/rest/projects?locator=count:30,start:10",
"nextHref" : "/app/rest/projects?locator=count:30,start:40"
},
"maxAgents" : 10,
"ownerProject" : {
"virtual" : false,
"parentProjectName" : "S3 Buckets Test",
"vcsRoots" : {
"count" : 10,
"vcs-root" : [ "[[[vcs-root...|vcsroot.html]]]" ],
"prevHref" : "/app/rest/vcs-roots?locator=count:10,start:90",
"href" : "/app/rest/vcs-roots?locator=count:10,start:100",
"nextHref" : "/app/rest/vcs-roots?locator=count:10,start:110"
},
"projects" : {
"count" : 39,
"project" : [ "[[[project...|project.html]]]" ],
"prevHref" : "/app/rest/projects?locator=count:10,start:0",
"href" : "/app/rest/projects?locator=count:30,start:10",
"nextHref" : "/app/rest/projects?locator=count:30,start:40"
},
"defaultTemplate" : {
"template" : "[[[buildType...|buildtype.html]]]",
"paused" : false,
"output-parameters" : "[[[properties...|properties.html]]]",
"description" : "Deploys artifacts to the public registry",
"project" : "[[[project...|project.html]]]",
"investigations" : "[[[investigations...|investigations.html]]]",
"templateFlag" : false,
"type" : "regular",
"uuid" : "8e7eafb8-321b-456e-84db-e73714c8fa3f",
"projectInternalId" : "project762",
"internalId" : "bt1057",
"features" : "[[[features...|features.html]]]",
"builds" : "[[[builds...|builds.html]]]",
"links" : "[[[links...|links.html]]]",
"id" : "Deployments_DeployToGlobal",
"href" : "/app/rest/buildTypes/id:Deployments_DeployToGlobal",
"compatibleCloudImages" : "[[[cloudImages...|cloudimages.html]]]",
"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" : false,
"agent-requirements" : "[[[agent-requirements...|agentrequirements.html]]]",
"webUrl" : "https://localhost:8111/buildConfiguration/Deployments_DeployToGlobal?mode=builds",
"inherited" : false,
"snapshot-dependencies" : "[[[snapshot-dependencies...|snapshotdependencies.html]]]",
"name" : "Deploy To Global",
"vcs-root-entries" : "[[[vcs-root-entries...|vcsrootentries.html]]]",
"projectName" : "Deployments",
"projectId" : "Deployments",
"parameters" : "[[[properties...|properties.html]]]",
"locator" : "locator"
},
"description" : "This subproject contains configurations that carry out delivery jobs",
"uuid" : "37dccab8-ddf9-4f81-a1ad-7815f0e841e1",
"parentProjectInternalId" : "project82",
"cloudProfiles" : {
"count" : 4,
"prevHref" : "/app/rest/cloud/profiles?locator=count:50,start:0",
"href" : "/app/rest/cloud/profiles",
"cloudProfile" : [ "[[[cloudProfile...|cloudprofile.html]]]" ],
"nextHref" : "/app/rest/cloud/profiles?locator=count:200,start:250"
},
"internalId" : "project302",
"archived" : false,
"parentProjectId" : "S3BucketsTest",
"deploymentDashboards" : {
"count" : 7,
"deploymentDashboard" : [ "[[[deploymentDashboard...|deploymentdashboard.html]]]" ],
"prevHref" : "prevHref",
"href" : "href",
"nextHref" : "nextHref"
},
"links" : {
"link" : [ "[[[link...|link.html]]]" ],
"count" : 4
},
"id" : "BuildCacheNodeJS",
"href" : "/app/rest/projects/id:BuildCacheNodeJS",
"parentProject" : {
"virtual" : false,
"parentProjectName" : "S3 Buckets Test",
"vcsRoots" : "[[[vcs-roots...|vcsroots.html]]]",
"projects" : "[[[projects...|projects.html]]]",
"defaultTemplate" : "[[[buildType...|buildtype.html]]]",
"description" : "This subproject contains configurations that carry out delivery jobs",
"uuid" : "37dccab8-ddf9-4f81-a1ad-7815f0e841e1",
"parentProjectInternalId" : "project82",
"cloudProfiles" : "[[[cloudProfiles...|cloudprofiles.html]]]",
"internalId" : "project302",
"archived" : false,
"parentProjectId" : "S3BucketsTest",
"deploymentDashboards" : "[[[deploymentDashboards...|deploymentdashboards.html]]]",
"links" : "[[[links...|links.html]]]",
"id" : "BuildCacheNodeJS",
"href" : "/app/rest/projects/id:BuildCacheNodeJS",
"parentProject" : "[[[project...|project.html]]]",
"templates" : "[[[buildTypes...|buildtypes.html]]]",
"readOnlyUI" : "[[[StateField...|statefield.html]]]",
"webUrl" : "https://localhost:8111/project.html?projectId=BuildAndDeploy",
"buildTypes" : "[[[buildTypes...|buildtypes.html]]]",
"name" : "Build Cache — NodeJS",
"ancestorProjects" : "[[[projects...|projects.html]]]",
"parameters" : "[[[properties...|properties.html]]]",
"projectFeatures" : "[[[projectFeatures...|projectfeatures.html]]]",
"locator" : "locator"
},
"templates" : {
"buildType" : [ "[[[buildType...|buildtype.html]]]" ],
"count" : 30,
"prevHref" : "/app/rest/vcs-roots?locator=count:20,start:0",
"href" : "/app/rest/vcs-roots?locator=count:30,start:20",
"nextHref" : "/app/rest/vcs-roots?locator=count:30,start:50"
},
"readOnlyUI" : {
"inherited" : true,
"value" : true
},
"webUrl" : "https://localhost:8111/project.html?projectId=BuildAndDeploy",
"buildTypes" : {
"buildType" : [ "[[[buildType...|buildtype.html]]]" ],
"count" : 30,
"prevHref" : "/app/rest/vcs-roots?locator=count:20,start:0",
"href" : "/app/rest/vcs-roots?locator=count:30,start:20",
"nextHref" : "/app/rest/vcs-roots?locator=count:30,start:50"
},
"name" : "Build Cache — NodeJS",
"ancestorProjects" : {
"count" : 39,
"project" : [ "[[[project...|project.html]]]" ],
"prevHref" : "/app/rest/projects?locator=count:10,start:0",
"href" : "/app/rest/projects?locator=count:30,start:10",
"nextHref" : "/app/rest/projects?locator=count:30,start:40"
},
"parameters" : {
"count" : 1,
"property" : [ {
"inherited" : true,
"name" : "name",
"type" : "[[[type...|type.html]]]",
"value" : "value"
} ],
"href" : "href"
},
"projectFeatures" : {
"projectFeature" : [ "[[[projectFeature...|projectfeature.html]]]" ],
"count" : 9,
"href" : "href"
},
"locator" : "locator"
},
"name" : "Kubernetes",
"id" : 31,
"href" : "/app/rest/agentPools/id:82",
"locator" : "locator",
"agents" : {
"agent" : [ "[[[agent...|agent.html]]]" ],
"count" : 7,
"prevHref" : "/app/rest/agents?locator=count:50,start:0",
"href" : "/app/rest/agents",
"nextHref" : "/app/rest/agents?locator=count:200,start:250"
},
"agentTypes" : {
"agentType" : [ "[[[agentType...|agenttype.html]]]" ],
"count" : 1,
"prevHref" : "/app/rest/agentTypes?locator=count:50,start:0",
"href" : "/app/rest/agentTypes",
"nextHref" : "/app/rest/agentTypes?locator=count:200,start:250"
}
}
Last modified: 02 December 2025