Managing Jobs

Jobs represent build configurations in TeamCity. The teamcity job command group lets you list and view build configurations, pause and resume them, and manage their parameters.

Listing jobs

View all build configurations:

teamcity job list

Filter by project:

teamcity job list --project MyProject

Limit the number of results:

teamcity job list --limit 20

Output as JSON:

teamcity job list --json
teamcity job list --json=id,name,projectName,webUrl

job list flags

Flag	Description
`-p`, `--project`	Filter by project ID
`-n`, `--limit`	Maximum number of jobs to display
`--json`	Output as JSON. Use `--json=` to list available fields, `--json=f1,f2` for specific fields.

Viewing job details

View details of a build configuration:

teamcity job view MyProject_Build

Open the job page in your browser:

teamcity job view MyProject_Build --web

Output as JSON:

teamcity job view MyProject_Build --json

Dependency tree

Visualize the snapshot dependency chain for a job. By default, the tree shows both dependents (what gets triggered after this job) and dependencies (what must run before this job):

teamcity job tree MyProject_DeployStaging

Show only one direction:

teamcity job tree MyProject_Build --only dependents
teamcity job tree MyProject_Deploy --only dependencies

Limit the tree depth:

teamcity job tree MyProject_Build --depth 2

job tree flags

Flag	Description
`-d`, `--depth`	Limit tree depth (0 = unlimited)
`--only`	Show only `dependents` or `dependencies`

Pausing and resuming jobs

Pause a job to prevent new builds from being triggered:

teamcity job pause MyProject_Build

Resume a paused job to allow new builds:

teamcity job resume MyProject_Build

Managing job parameters

Listing parameters

View all parameters defined on a job:

teamcity job param list MyProject_Build
teamcity job param list MyProject_Build --json

Getting a parameter value

Retrieve the value of a specific parameter:

teamcity job param get MyProject_Build VERSION
teamcity job param get MyProject_Build env.JAVA_HOME

Setting a parameter

Set or update a parameter value:

teamcity job param set MyProject_Build VERSION "2.0.0"

To mark a parameter as secure (password field), use the --secure flag. Secure parameters have their values hidden in the web interface and build logs:

teamcity job param set MyProject_Build SECRET_KEY "my-secret-value" --secure

Deleting a parameter

Remove a parameter from a job:

teamcity job param delete MyProject_Build MY_PARAM

23 February 2026