TeamCity REST API Reference 2024.07 Help

Manage Investigations

This article lists REST API requests concerning investigations.

List Investigations

To get a list of all investigations on the server, use:

/app/rest/investigations

The request responds with Investigations which contains instances of an Investigation entity.

To get specific investigations, use:

/app/rest/investigations/<investigationLocator>

investigationLocator is typed as InvestigationLocator. For example, to get investigations for a test named MyTest, use:

/app/rest/investigations?locator=test:(name:MyTest)

To find investigations assigned to the MyUser user, use:

/app/rest/investigations?locator=assignee:(username:MyUser)

To find all investigations related to a given build type, use:

/app/rest/investigations?locator=buildType:(id:MyBuildConfigurationID)

Assign/Replace Investigations

To assign a single investigation, POST Investigation to:

/app/rest/investigations

Example payload:

<investigation state="TAKEN"> <assignee username="MyUsername"/> <scope><buildType id="MyBuildConfigurationID"/></scope> <target anyProblem="true"/> <resolution type="whenFixed"/> </investigation>
{ "scope" : { "buildType" : { "id" : "MyBuildConfigurationID" } }, "state" : "TAKEN", "assignee" : { "username" : "MyUsername" }, "resolution" : { "type" : "whenFixed" }, "target" : { "anyProblem" : true } }

To update an existing investigation, PUT an Investigation entity to:

/app/rest/investigations/<investigationLocator>

To create multiple investigations with a single request, POST (or PUT) an Investigations entity to:

/app/rest/investigations/multiple

Example payload:

<investigations> <investigation>investigation description as per above example...</investigation> <investigation>investigation description as per above example...</investigation> <investigation>investigation description as per above example...</investigation> </investigations>
{ "investigation" : [ { investigation description as per above example... }, { investigation description as per above example... }... ] }

Delete Investigation

To delete an investigation, use:

/app/rest/investigations/<investigationLocator>
Last modified: 29 March 2022