package_versions

Overview

Name	package_versions
Type	Resource
Id	github.packages.package_versions

Fields

Name	Datatype	Description
id	integer	Unique identifier of the package version.
name	string	The name of the package version.
description	string
metadata	object
updated_at	string
license	string
package_html_url	string
url	string
deleted_at	string
html_url	string
created_at	string

Methods

Name	Accessible by	Required Params	Description
get_all_package_versions_for_package_owned_by_authenticated_user	SELECT	package_name, package_type	Returns all package versions for a package owned by the authenticated user. To use this endpoint, you must authenticate using an access token with the packages:read scope. If package_type is not container, your token must also include the repo scope.
get_all_package_versions_for_package_owned_by_org	SELECT	org, package_name, package_type	Returns all package versions for a package owned by an organization. To use this endpoint, you must authenticate using an access token with the packages:read scope. If package_type is not container, your token must also include the repo scope.
get_all_package_versions_for_package_owned_by_user	SELECT	package_name, package_type, username	Returns all package versions for a public package owned by a specified user. To use this endpoint, you must authenticate using an access token with the packages:read scope. If package_type is not container, your token must also include the repo scope.
get_package_version_for_authenticated_user	SELECT	package_name, package_type, package_version_id	Gets 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 packages:read scope. If package_type is not container, your token must also include the repo scope.
get_package_version_for_organization	SELECT	org, package_name, package_type, package_version_id	Gets a specific package version in an organization. You must authenticate using an access token with the packages:read scope. If package_type is not container, your token must also include the repo scope.
get_package_version_for_user	SELECT	package_name, package_type, package_version_id, username	Gets a specific package version for a public package owned by a specified user. At this time, to use this endpoint, you must authenticate using an access token with the packages:read scope. If package_type is not container, your token must also include the repo scope.
delete_package_version_for_authenticated_user	DELETE	package_name, package_type, package_version_id	Deletes 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 packages:read and packages:delete scopes. If package_type is not container, your token must also include the repo scope.
delete_package_version_for_org	DELETE	org, package_name, package_type, 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 packages:read and packages:delete scopes. In addition: - If package_type is not container, your token must also include the repo scope. - If package_type is container, you must also have admin permissions to the container you want to delete.
delete_package_version_for_user	DELETE	package_name, package_type, package_version_id, username	Deletes a specific package version for a 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 authenticate using an access token with the packages:read and packages:delete scopes. In addition: - If package_type is not container, your token must also include the repo scope. - If package_type is container, you must also have admin permissions to the container you want to delete.
restore_package_version_for_authenticated_user	EXEC	package_name, package_type, package_version_id	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 packages:read and packages:write scopes. If package_type is not container, your token must also include the repo scope.
restore_package_version_for_org	EXEC	org, package_name, package_type, package_version_id	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 packages:read and packages:write scopes. In addition: - If package_type is not container, your token must also include the repo scope. - If package_type is container, you must also have admin permissions to the container that you want to restore.
restore_package_version_for_user	EXEC	package_name, package_type, package_version_id, username	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 packages:read and packages:write scopes. In addition: - If package_type is not container, your token must also include the repo scope. - If package_type is container, you must also have admin permissions to the container that you want to restore.