Back to GithubRestore package version for an organization
Restores a specific package version in an organization.
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 have admin permissions in the organization and 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."
Input
type: object
properties:
parameters:
type: object
properties:
package_type:
type: string
enum:
- npm
- maven
- rubygems
- docker
- nuget
- container
description: >-
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:
type: string
description: The name of the package.
org:
type: string
description: The organization name. The name is not case sensitive.
package_version_id:
type: integer
description: Unique identifier of the package version.
required:
- package_type
- package_name
- org
- package_version_id
title: Parameters