Restore package version for a user

POST

/users/{username}/packages/{package_type}/{package_name}/versions/{package_version_id}/restore

Restores a specific package version for a user.

You can restore a deleted package under the following conditions:

The package was deleted within the last 30 days.

The same package namespace and version is still available and not reused for a new package. If the same package namespace is not available, you will not be able to restore your package. In this scenario, to restore the deleted package, you must delete the new package that uses the deleted package's namespace first.

To use this endpoint, you must authenticate using an access token with the read:packages and write: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 restore. For the list of these registries, see "About permissions for GitHub Packages."

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.github.com/users//packages///versions//restore'

Response Example

204 - Example 1

{}

Request

Path Params

Responses

🟢204Response

application/json

Body

🟠401401

🟠403403

🟠404404

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

Get a package version for a user

List organization projects