Managing Agent Pools
Agent pools group build agents and control which projects can use them. The teamcity pool command group lets you list pools, view pool details, and manage project-pool associations.
Listing pools
View all configured agent pools:
teamcity pool list
Output as JSON:
teamcity pool list --json
teamcity pool list --json=id,name,maxAgents
Viewing pool details
View details of a specific pool, including its agents and linked projects:
teamcity pool view 0
teamcity pool view 1 --web
teamcity pool view 1 --json
Linking projects to pools
Link a project to an agent pool, allowing the project's builds to run on agents in that pool:
teamcity pool link 1 MyProject
The first argument is the pool ID, and the second is the project ID.
Unlinking projects from pools
Remove a project's access to agents in a pool:
teamcity pool unlink 1 MyProject
22 February 2026