TeamCity REST API Reference 2026.2 Help

Problem

Represents a build problem — a non-test failure that caused a build to fail, such as a compilation error, a non-zero process exit code, or a failed artifact publication. A Problem is the unique failure type identified by its type and identity combination. Each time a build encounters this failure it produces a ProblemOccurrence. This is analogous to Test (the unique test) and TestOccurrence (one run of it in a specific build).

Properties

id

The ID of this build problem.

type

The type code of this build problem.

identity

The stable identifier of this build problem, shared across builds.

href

The relative link (without the TeamCity server URL) used to retrieve this object.

description

A human-readable description of the build problem.

mutes

The list of mutes applied to this build problem.

investigations

The list of investigations assigned to this build problem.

problemOccurrences

The occurrences of this build problem across builds.

locator

A locator string used to identify this problem when submitting via POST. Not returned in responses.

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.

<problem description="string" href="/app/rest/problems/id:211" id="211" identity="simpleRunnerfail_build_127" locator="id:211" type="TC_EXIT_CODE"> <mutes count="1" href="/app/rest/mutes" nextHref="/app/rest/mutes?locator=start:100" prevHref="/app/rest/mutes?locator=start:0"> <mute>[[[mute...|mute.html]]]</mute> </mutes> <investigations count="30" href="/app/rest/investigations?locator=count:3,start:5" nextHref="/app/rest/investigations?locator=count:3,start:8" prevHref="/app/rest/investigations?locator=count:3,start:2"> <investigation>[[[investigation...|investigation.html]]]</investigation> </investigations> <problemOccurrences count="1" failed="3" href="/app/rest/problemOccurrences?locator=build:(id:22011)" ignored="2" muted="0" newFailed="1" nextHref="/app/rest/problemOccurrences?locator=build:(id:22011),start:100" passed="42" prevHref="/app/rest/problemOccurrences?locator=build:(id:22011),start:0"> <problemOccurrence>[[[problemOccurrence...|problemoccurrence.html]]]</problemOccurrence> </problemOccurrences> </problem>
{ "problemOccurrences" : "[[[problemOccurrences...|problemoccurrences.html]]]", "identity" : "simpleRunnerfail_build_127", "description" : "description", "investigations" : "[[[investigations...|investigations.html]]]", "id" : "211", "href" : "/app/rest/problems/id:211", "type" : "TC_EXIT_CODE", "mutes" : "[[[mutes...|mutes.html]]]", "locator" : "id:211" }
Last modified: 18 August 2026