Test

Represents a test.

Properties

id

The internal numeric ID of this test.

name

The fully qualified name of this test.

mutes

The list of mutes applied to this test.

investigations

The list of investigations assigned to this test.

testOccurrences

The occurrences of this test across builds.

parsedTestName

The parsed components of the fully qualified test name.

href

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

locator

A locator string used to identify this test 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.

<test href="/app/rest/tests/id:123456789" id="123456789" locator="id:123456789" name="com.mycompany.app.AppTest.testAppMessage">
  <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>
  <testOccurrences count="5" failed="1" href="/app/rest/testOccurrences?locator=build:(id:22011)" ignored="0" muted="1" newFailed="1" nextHref="/app/rest/testOccurrences?locator=build:(id:22011),start:100" passed="3" prevHref="/app/rest/testOccurrences?locator=build:(id:22011),start:0">
    <testOccurrence>[[[testOccurrence...|testoccurrence.html]]]</testOccurrence>
    <testCounters>[[[testCounters...|testcounters.html]]]</testCounters>
  </testOccurrences>
  <parsedTestName testClass="com.mycompany.app.AppTest" testMethodName="testAppMessage" testNameWithParameters="testAppMessage[param1]" testNameWithoutPrefix="testAppMessage" testPackage="com.mycompany.app" testShortName="testAppMessage" testSuite="AppTest"/>
</test>

{
  "testOccurrences" : "[[[testOccurrences...|testoccurrences.html]]]",
  "name" : "com.mycompany.app.AppTest.testAppMessage",
  "investigations" : "[[[investigations...|investigations.html]]]",
  "parsedTestName" : "[[[ParsedTestName...|parsedtestname.html]]]",
  "id" : "123456789",
  "href" : "/app/rest/tests/id:123456789",
  "mutes" : "[[[mutes...|mutes.html]]]",
  "locator" : "id:123456789"
}

Last modified: 18 August 2026