Internet Explorer is no longer supported. Many things will still work, but your experience will be degraded and some things won't function. Please use a modern browser such as Edge, Chrome, or Firefox.

Cancel Release

view on GitHub

The Cancel Release is an endpoint in BuildMaster's Release & Build Deployment API that will cancel a release, with the parameters defined in the body of the request.

Request Specification

POST/PUT /api/releases/cancel

To cancel a release, simply POST or PUT to the URL with an appropriate API Key and a request body, containing the following parameters:

Input Parameter Specification
Release Required. Either a key named releaseId with an integer value, or a key named releaseNumber with any value.
Application Required if releaseNumber is specified, otherwise must not be set. Either a key named applicationId with an integer value, or a key named applicationName with any value.
Reason Optional. A key named reason with any value.

Rejecting a build requires parameters defined in the request body.

POST /api/releases/cancel

{
  "releaseNumber": "1.0.1",
  "applicationName": "TaxCalculator"
}

Response Specification

Response Details
200 (Success) the specified release was cancelled
400 (Invalid Input) indicates invalid or missing properties in the request; the body will provide some details as text
403 (Unauthorized API Key) indicates a missing, unknown, or unauthorized API Key; the body will be empty