TeamCity

List build agents with their connection and enabled state. Returns agent IDs for trigger_build’s agent_id and…

Get one build agent by ID, including version, IP, pool and enabled state. Use list_agents to find valid IDs.

Enable or disable a build agent. A disabled agent stays connected but takes no new builds, which is how you drain an…

List agent pools, which group build agents and scope them to projects. Returns pool IDs to pass as list_agents’ pool…

List builds with server-side filtering by configuration, project, branch, status, state, agent, user, tag or date…

Get one build by ID, including status, timings, agent and what triggered it. Use list_builds to find valid IDs. Pass…

Get a bounded slice of a build’s log as plain text. Defaults to the LAST 200 lines, where failures appear. Build…

Get a build’s recorded statistics as name/value pairs, such as BuildDuration, ArtifactsSize, AllTestsDuration and…

List files and directories in a build’s artifacts. Omit path for the artifact root, then pass a directory name to…

List the tags on a build. Use list_builds to find build IDs.

Add one or more tags to a build. Existing tags are kept, this appends rather than replaces. Use list_build_tags to…

Pin or unpin a build. A pinned build is exempt from TeamCity’s cleanup rules, so it is how you preserve a release…

Set or replace the comment on a build, for example to record why it was kept or what it shipped. Use list_builds to…

Cancel a RUNNING build, optionally re-queueing an identical one. For a build still waiting in the queue use…

List build configurations with server-side filtering by project, name, or paused state. This is how you find the…

Get a single build configuration by ID. Use list_build_types to find valid IDs. Pass fields=‘$long’ for the full…

Create a build configuration in a project. name and project_id are both required, use list_projects to find a valid…

Permanently delete a build configuration and its build history. Use list_build_types to confirm the ID first. To…

Pause or resume a build configuration. A paused configuration starts no new builds from triggers, but can still be…

List a build configuration’s build parameters, including those inherited from its project or template. Use these…

Create or update a single build parameter on a build configuration. Use list_build_type_parameters to see existing…

List a build configuration’s build steps, with each step’s runner type and whether it is disabled. Use…

List a build configuration’s build triggers (VCS, schedule, dependency) and whether each is disabled. Use…

List branches known to a build configuration, flagging the default and which are active. This is how you find a…

List the VCS roots attached to a build configuration, with their checkout rules. Returns VCS root IDs for…

List VCS changes (commits) with their messages and authors. Pass build to see what went into a specific build, or…

Get one VCS change by ID, including the list of files it touched. Use list_changes to find valid IDs.

List investigations, who has taken ownership of which failures. Filter by assignee, build configuration, project,…

Assign an investigation so a named user owns a failure. Requires assignee_username plus a scope (build_type_id or…

Delete an investigation, releasing ownership of the failure. Pass the investigation id from list_investigations…

List muted tests and build problems, failures deliberately hidden from build status. Filter by project, reporter,…

Mute failing tests or build problems so they stop failing builds. Requires a scope (project_id or build_type_id) and…

Unmute a test or build problem so its failures count again. Use list_mutes to find the mute ID.

List non-test build failures (compilation errors, exit codes, dependency failures) with their failure messages. Pass…

Look up build problems by their server-wide identity, to answer ‘what is failing or muted in this project’. Requires…

List TeamCity projects with server-side filtering by name, archived state, or parent. Use parent_project for direct…

Get a single TeamCity project by ID. Use list_projects to find valid IDs. Pass fields=‘$long’ for the full object…

Create a TeamCity project. Only name is required. Use list_projects to find a parent_project_id, or omit it to…

Permanently delete a TeamCity project along with all of its build configurations and build history. Use…

List a project’s build parameters, which its build configurations inherit. Use list_projects to find valid project…

Create or update a single build parameter on a project. Use list_project_parameters to see existing names, and…

Delete a single build parameter from a project. Use list_project_parameters to see existing names.

Queue a new build. build_type_id is required, get it from list_build_types. For branch_name use…

List builds waiting in the build queue, with each one’s queue position and why it has not started. Filter by build…

Get one queued build by ID, including its queue position, wait reason and estimated start. Use the ID returned by…

Remove a build from the queue before it starts. For a build already running use cancel_build instead. Use…

Pause or resume the entire TeamCity build queue server-wide. While paused no queued build starts, though builds can…

Get TeamCity server version, build number, start time and web URL. Use to confirm connectivity or check the server…

List individual test runs, filtered by build, configuration, status, or branch. This is the main way to see which…

Get one test run including its failure details and stack trace. Pass the compound id from list_test_occurrences…

Look up tests by their server-wide identity, to answer ‘what is failing or muted in this project’. Requires a…

List TeamCity users filtered by username, name, email or group. Returns the usernames needed by…

Get one TeamCity user by ID or username, including role assignments and group memberships. Provide user_id or…

List VCS roots (configured repository connections) filtered by name, provider type or project. Use…

Get one VCS root by ID. Use list_vcs_roots to find valid IDs. Add ‘properties(property(name,value))’ to fields to…

Ask TeamCity to check a VCS root for new commits now, instead of waiting for its polling interval. Use this after…