This version of GitHub Enterprise was discontinued on 2021-09-23. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Deleting a package

You can delete a version of a private package using GraphQL or on GitHub Enterprise Server.

GitHub Packages is available with GitHub Free, GitHub Pro, GitHub Free for organizations, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server, and GitHub AE.

Note: GitHub Packages is currently in beta for GitHub Enterprise Server 2.22. To join the beta for your GitHub Enterprise Server instance, use the sign-up form.

At this time, GitHub Packages on your GitHub Enterprise Server instance does not support deleting public packages.

You can only delete a specified version of a private package on GitHub Enterprise Server or with the GraphQL API. To remove an entire private package from appearing on GitHub Enterprise Server, you must delete every version of the package first.

Deleting a version of a private package on GitHub Enterprise Server

To delete a private package version, you must have admin permissions in the repository.

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.

  2. To the right of the list of files, click Packages.

    Packages link on repo overview page

  3. Click the name of the package that you want to delete. Package name

  4. On the right, use the Edit package drop-down and select "Manage versions". Package name

  5. To the right of the version you want to delete, click Delete. Delete package button

  6. To confirm deletion, type the package name and click I understand the consequences, delete this version. Confirm package deletion button

Deleting a version of a private package with GraphQL

Use the deletePackageVersion mutation in the GraphQL API. You must use a token with the read:packages, delete:packages, and repo scopes. For more information about tokens, see "About GitHub Packages."

Here is an example cURL command to delete a package version with the package version ID of MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg, using a personal access token.

curl -X POST \
-H "Accept: application/vnd.github.package-deletes-preview+json" \
-H "Authorization: bearer TOKEN" \
-d '{"query":"mutation { deletePackageVersion(input:{packageVersionId:\"MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg==\"}) { success }}"}' \

To find all of the private packages you have published to GitHub Packages, along with the version IDs for the packages, you can use the packages connection through the repository object. You will need a token with the read:packages and repo scopes. For more information, see the packages connection or the PackageOwner interface.

For more information about the deletePackageVersion mutation, see "deletePackageVersion."

You cannot delete an entire package, but if you delete every version of a package, the package will no longer show on GitHub Enterprise Server.