Restore a package version for the authenticated user

POST

/user/packages/{package_type}/{package_name}/versions/{package_version_id}/restore

Restores a package version owned by the authenticated user.

You can restore a deleted package version 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. 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 GitHub Packages registries that only support repository-scoped permissions, see "About permissions for GitHub Packages."

Request Example

Shell

JavaScript

Java

Swift

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

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.

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

Get a package version for the authenticated user

List packages for a user