Control Build Retention

Description: Specifies retention parameters for build info

Since: 5.2.1

Note: A promoted Build Info cannot be deleted using this API.

Security: Requires a privileged user. From version 6.6, requires delete permission for the build.

Usage: POST /api/build/retention/{buildName}?async=<true | false>

Consumes: application/json

{ 
    "deleteBuildArtifacts" : <true | false>,    // When true, automatically removes build artifacts stored in Artifactory 
    "count" : <count>,                                                  // The maximum number of builds to store in Artifactory.
    "minimumBuildDate" : <date>,                                // Earliest build date to store in Artifactory - ISO8601 (yyyy-MM-dd'T'HH:mm:ss.SSSZ)
    "buildNumbersNotToBeDiscarded" : [ ]              // List of build numbers that should not be removed from Artifactory
}

Sample Usage:

POST /api/build/retention/myBuild?async=true

{ 
    "deleteBuildArtifacts" : true, 
    "count" : 100, // 
    "minimumBuildDate" : 1407345768020, 
    "buildNumbersNotToBeDiscarded" : [ 5, 9] 
}