Get Releases

The Get Releases is an endpoint in BuildMaster's Release & Build Deployment API that will return an array of ReleaseInfo objects describing releases in the instance, based on the specified optional filter parameters.

curl -X POST -H "X-ApiKey: abc12345" -H "Content-Type: application/json" -d "{\"status\": \"active\"}" "https://proget.corp.local/api/releases"

Request Specification

To get a list of releases, simply GET or POST to the URL with an appropriate API Key and a request body, applying the following optional filter parameters:

GET/POST /api/releases

Getting releases permits specified filters as the request body:

GET /api/releases

{
  "status": "active"
}

Response Specification

A successful (200) response body will contain an array of ReleaseInfo objects. For example, getting all active releases returns:

[
  {
    "id": 4,
    "number": "1.0.1",
    "name": "1.0.1",
    "sequence": 2,
    "status": "active",
    "createdBy": "MikeJones",
    "createdOn": "2024-03-04T09:03:43.9200000Z",
    "applicationId": 2,
    "applicationName": "ProfitCalculator",
    "pipelineName": "Release",
    "furthestBuildId": 6,
    "furthestBuildNumber": "2",
    "latestBuildId": 6,
    "latestBuildNumber": "2",
    "deployables": [],
    "furthestPackageId": 6,
    "furthestPackageNumber": "2",
    "latestPackageId": 6,
    "latestPackageNumber": "2",
    "releaseName": "1.0.1",
    "releaseNumber": "1.0.1"
  },
  {
    "id": 1,
    "number": "1",
    "name": "1",
    "sequence": 1,
    "status": "active",
    "createdBy": "JohnSmith",
    "createdOn": "2024-03-04T08:42:38.8170000Z",
    "applicationId": 1,
    "applicationName": "TaxCalculator",
    "deployables": [],
    "releaseName": "1",
    "releaseNumber": "1"
  },
  { ... }
]