Delete Package

Delete Package is available as both a pgutil command and an HTTP Request, and will delete a single package from the specified feed.

pgutil packages delete --feed=myNugetFeed --package=myNugetPackage --version=1.0.0

This API requires ProGet 2023.0 or later.

Command Specification (CLI)

The packages delete command set is used to delete a package from a feed.

The --package and --version options are always required, and the --qualifier option is required for multifile packages like Debian and RubyGems.

Deleting an npm Package requires the feed (e.g. MyNpmFeed), name (e.g. @myscope/my-npm-package) and version (e.g. 2.0.0):

pgutil packages delete --feed=MyNpmFeed --pacakge=@my-scope/my-npm-package --version=2.0.0

Deleting a Python Package requires the name (e.g. myPythonPackage), version (e.g. 3.0.0), and a quoted qualifier with the filename (e.g. filename=myPythonPackage.3.0.0.tgz:

pgutil packages delete --feed=MyPythonFeed --package=myPythonPackage --version=3.0.0 --qualifier="filename=myPythonPackage.3.0.0.tgz"

Deleting a Debian Package requires the name (e.g. myDebianPackage), version (e.g. 4.0.0), component (e.g. main), and a quoted qualifier with the architecture (e.g. arch=amd64):

pgutil packages delete --feed=MyDebianFeed --package=main/myDebianPackage --version=4.0.0 --qualifier="arch=amd64"

Note source options must also be specified unless you have the "Default" source configured, and that a feed may be instead specified in the source. See Working with Sources to learn more.

HTTP Request Specification

To delete a package, simply POST to the URL with a feed name, package identifiers, and an appropriate API Key.

POST /api/packages/«feed-name»/delete?«package-identifiers»

Unless you use a purl, the parameters required will vary by feedtype.

Deleting a NuGet Package requires the name (e.g. myNugetPackage) and version (e.g. 1.0.0):

POST /api/packages/MyNugetFeed/delete?name=myNugetPackage&version=1.0.0

Deleting an npm Package requires the name (e.g. my-npm-package) and version (e.g. 2.0.0), and optionally a scope (e.g. @myscope) that's specified without the at-symbol:

POST  /api/packages/MyNpmFeed/delete?group=my-scope&name=my-npm-package&version=2.0.0

Alternatively, you can use the purl:

POST  /api/packages/MyNpmFeed/delete?purl=pkg:npm/my-scope/my-npm-package@2.0.0

Deleting a Python Package requires the name (e.g. myPythonPackage), version (e.g. 3.0.0), and a URL-encoded qualifier with the filename (e.g. filename=myPythonPackage.3.0.0.tgz:

POST /api/packages/MyPythonFeed/delete?name=myPythonPackage&version=3.0.0&qualifier=filename%3DmyPythonPackage.3.0.0.tgz

Deleting a Debian Package requires the name (e.g. myDebianPackage), version (e.g. 4.0.0), component (e.g. main), and a URL-encoded qualifier with the architecture (e.g. arch=amd64):

POST /api/packages/MyDebianFeed/delete?group=main&name=myDebianPackage&version=4.0.0&qualifier=arch%3Damd64

HTTP Response Specification

Sample Usage Scripts

Delete All Packages Except for Latest Version (Powershell)

The following script will delete all non-latest versions of GeneralUtils.NET in the private-nuget feed.

$baseUrl = "https://proget.corp.local/api/packages"
$feedName = "private-nuget"
$packageName = "GeneralUtils.NET"
$apiKey = "a1b2c3d4e5"

$allVersionsUrl = "$baseUrl/$feedName/versions?name=$packageName"
$allVersions = Invoke-RestMethod -Uri $allVersionsUrl -Headers @{"X-ApiKey" = $apiKey}

$latestVersionUrl = "$baseUrl/$feedName/latest?name=$packageName"
$latestVersion = Invoke-RestMethod -Uri $latestVersionUrl -Headers @{"X-ApiKey" = $apiKey}

foreach ($version in $allVersions) 
    {
        if ($version.Version -ne $latestVersion.Version) 
            {
                $deleteVersionUrl = "$baseUrl/$feedName/delete?name=$packageName&version=$($version.Version)"
            Invoke-RestMethod -Uri $deleteVersionUrl -Headers @{"X-ApiKey" = $apiKey} -Method POST
            Write-Host "Deleted version $($version.Version)"
        }
    }

Write-Host "All old versions of $packageName have been deleted, except for the latest version $($latestVersion.Version)."

This returns:

Deleted version 3.0.3-beta1
Deleted version 2.0.2
Deleted version 2.0.2-beta3
All old versions of GeneralUtils.NET have been deleted, except for the latest version 3.0.3.

Delete All Pre-release (Alpha or Beta) Versions of a Package (Python)

The following script will delete all "alpha" and "beta" versions of the GeneralUtils.NET package in the private-nuget, leaving only release versions in the feed.

import requests

packageName = "GeneralUtils.NET"
baseUrl = "https://proget.corp.local/api/packages/private-nuget"
apiKey = "a1b2c3d4e5"

package_info_url = f"{baseUrl}/versions?name={packageName}"

headers = {"X-ApiKey": apiKey}

response = requests.get(package_info_url, headers=headers)

if response.status_code == 200:
    package_info = response.json()

    for version in package_info:
        package_name = version["Name"]
        package_version = version["Version"]

        if "beta" in package_version or "alpha" in package_version:
            delete_url = f"{baseUrl}/delete?name={package_name}&version={package_version}"
            response = requests.post(delete_url, headers=headers)

            if response.status_code == 200:
                print(f"{package_name} version {package_version} deleted.")
            else:
                print(f"Failed to delete {package_name} version {package_version}.")

    print(f"All 'beta' or 'alpha' versions of {packageName} have been deleted.")
else:
    print(f"Failed to retrieve package information for {packageName}. Status code: {response.status_code}")

Running this script will output something like this:

GeneralUtils.NET version 13.0.3-beta1 deleted.
GeneralUtils.NET version 13.0.2-beta3 deleted.
All 'beta' or 'alpha' versions of GeneralUtils.NET have been deleted.