Skip to main content

auth_user_versions

Overview

Nameauth_user_versions
TypeResource
Idgithub.packages.auth_user_versions

Fields

NameDatatypeDescription
idintegerUnique identifier of the package version.
namestringThe name of the package version.
descriptionstring
licensestring
html_urlstring
urlstring
metadataobject
updated_atstring
package_html_urlstring
deleted_atstring
created_atstring

Methods

NameAccessible byRequired ParamsDescription
get_all_package_versions_for_package_owned_by_authenticated_userSELECTpackage_name, package_typeLists package versions for a package owned by the authenticated user.

To use this endpoint, you must authenticate using an access token with the read:packages scope. 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."
get_package_version_for_authenticated_userSELECTpackage_name, package_type, package_version_idGets a specific package version for a package owned by the authenticated user.

To use this endpoint, you must authenticate using an access token with the read:packages scope. 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."
delete_package_version_for_authenticated_userDELETEpackage_name, package_type, package_version_idDeletes a specific package version for a package owned by the authenticated user. 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.
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."
restore_package_version_for_authenticated_userEXECpackage_name, package_type, package_version_idRestores 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."