Create/Update Build

Create Build is available as both a pgutil command and an HTTP Request, and will create a new build or update properties on an existing build, and return a BuildInfo Object object describing the new or updated build.

Note: this API endpoint functions by creating a new build when the version specified in the API request does not exist, else it updates an existing build.

pgutil builds create --build=1.2.3 --project=myProject 

Command Specification (CLI)

The builds create command is used to create a new build.

The --project and --build options are always required.

Creating a build requires the project name (e.g. myProject) and the build number to be created (e.g 1.2.3)

pgutil builds create --build=1.2.3 --project=myProject 

HTTP Request Specification

To create or update a build, simply POST to the URL with an appropriate API Key and a BuildInfo Object object as the request body.

POST /api/sca/releases

HTTP Response Specification

A successful (200) response body will contain a BuildInfo object. For example, to creating a new build version 1.2.3 of a project named myProject, the request would return this:

POST /api/sca/releases

{
  "version":"1.2.3",
  "active":true,
  "viewReleaseUrl":"https://proget.corp.local/projects/release?projectReleaseId=2",
  "viewIssuesUrl":"https://proget.corp.local/projects/release/issues?projectReleaseId=2"
}