TeamCity REST API Reference 2025.11 Help

ApprovableBuild

A build that cannot start until explicitly approved by designated team members. See the Build approval build feature and Untrusted Builds project settings for more information. Send a POST request to the /app/rest/buildQueue/{buildLocator}/approve endpoint to manually approve a build.

Properties

buildId

The ID of a build that requires manual approval.

buildTypeId

The ID of a build configuration that spawned this approvable build.

buildTypeName

The name of a build configuration that spawned this approvable build.

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.

<approvableBuild buildId="124" buildTypeId="Deployments_Deploy_to_global" buildTypeName="Deploy to global"/>
{ "buildTypeId" : "Deployments_Deploy_to_global", "buildTypeName" : "Deploy to global", "buildId" : "124" }
Last modified: 02 December 2025