Resetting the artifact paths of the build configuration to the paths inheritted from the template using REST API

Question

1. The build configuration has a template attached.
2. The template has artifact paths configured.
3. The artifact paths in the build configuration were modified, which overrides the value inherited from the template.
4. In the TeamCity UI > Build Configuration > Settings > General page, there is a Reset button near the Artifact paths field. Clicking this button resets the overridden value to the value inherited from the template.

Is there a way to imitate this artifact path reset behavior using the REST API?

Answer

There is no direct equivalent in the REST API for the artifact paths Reset button found in the UI.  However, it is possible to achieve the same results by using a PUT request to the build configuration's settings endpoint to directly modify the artifactRules value:

1. Use GET /app/rest/buildTypes/id:MyBuildConfigurationID/settings to get the current settings. The example response, in XML format: <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <properties count="2" href="/app/rest/buildTypes/settings">     <property name="artifactRules" value="logs/*.log"/>     <property name="buildNumberCounter" value="14"/> </properties>
2. Use PUT /app/rest/buildTypes/id:MyBuildConfigurationID/settings to modify the settings. The body of the request should include all properties enclosed in <properties>...</properties>.
3. To reset the artifact paths to the value inherited from the template, the artifactRules property in the body should include the artifactRules value from the template, along with the inherited="true" parameter.  Example of the body of such PUT request, in XML: <properties>     <property name="artifactRules" value="logs/*.log&#xA;logs/logs-subdir/*.log" inherited="true"/>     <property name="buildNumberCounter" value="14"/> </properties>

Additional information

If the inheritance is not strictly required, there is an easier way to modify the artifact paths via API. See Modifying artifact paths of build configuration using REST API.