Delete package version for an organization

DELETE

/orgs/{org}/packages/{package_type}/{package_name}/versions/{package_version_id}

Deletes a specific package version in an organization. If the package is public and the package version has more than 5,000 downloads, you cannot delete the package version. In this scenario, contact GitHub support for further assistance.

To use this endpoint, you must have admin permissions in the organization and authenticate using an access token with the read:packages and delete:packages scopes. In addition:

If the package_type belongs to a GitHub Packages registry that only supports repository-scoped permissions, your token must also include the repo scope. For the list of these registries, see "About permissions for GitHub Packages."

If the package_type belongs to a GitHub Packages registry that supports granular permissions, you must have admin permissions to the package whose version you want to delete. For the list of these registries, see "About permissions for GitHub Packages."

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.github.com/orgs//packages///versions/'

Response Example

204 - Example 1

{}

Request

Path Params

package_type

string

required

The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry.

package_name

string

required

The name of the package.

org

string

required

The organization name. The name is not case sensitive.

package_version_id

integer

required

Unique identifier of the package version.

Responses

🟢204Response

application/json

Body

object {0}

🟠401401

🟠403403

🟠404404

Modified at 2023-08-15 02:59:28

List package versions for a package owned by an organization

Get a package version for an organization