Build (1.0)

TFS 2017 | TFS 2015 | TFS 2013


Looking for REST APIS that support TFS 2018 or later versions? See the Azure DevOps REST API Reference.

api-version = 1.0

A build request references a build definition to add a new build to a build queue. Completed builds are assigned a build quality.

Build resources

Common tasks

Start a build

  1. Get the ID of the build definition that you want to use.
  2. Create a build request.
  3. Get the ID of the request from the response so you can use it later.

Postpone or cancel a build request

Before the build request has started, you can cancel or postpone it.

Get a build

  1. Get a list of builds and find the ID of the build you're interested in. For example, find the build that you requested by using the request ID.
  2. Get the details about the build.

Set the build quality

  1. If you don't know what qualities are available in your project, get the list of qualities.
  2. Set the quality of the build.
  3. You can also define what qualities are available.