# Delete Package Versions

This action deletes versions of a package from [GitHub Packages](https://github.com/features/packages). 

## What It Can Do

* Delete a single version
* Delete multiple versions
* Delete specific version(s) 
* Delete oldest version(s)
* Delete version(s) from a package that is hosted in the same repo that is executing the workflow
* Delete version(s) from a package that is hosted in a different repo than the one executing the workflow

# Usage

```yaml
- uses: actions/delete-package-versions@v1
	with:
		# Can be a single package version id, or a comma separated list of package version ids.
		# Defaults to an empty string.
		package-version-ids: ''
		
		# Owner of the repo hosting the package.
		# Defaults to the owner of the repo executing the workflow.
		# Required if deleting a version from a package hosted in a different repo than the one executing the workflow.
		owner: ''
		
		# Repo hosting the package.
		# Defaults to the repo executing the workflow.
		# Required if deleting a version from a package hosted in a different repo than the one executing the workflow.
		repo: ''
		
		# Name of the package.
		# Defaults to an empty string.
		# Required if `package-version-ids` input is not given.
		package-name: ''
		
		# The number of old versions to delete starting from the oldest version.
		# Defaults to 1.
		num-old-versions-to-delete: ''
		
		# The token used to authenticate with GitHub Packages.
		# Defaults to github.token.
		# Required if deleting a version from a package hosted in a different repo than the one executing the workflow.
		#   If `package-version-ids` is given the token only needs the delete packages scope.
		#   If `package-version-ids` is not given the token needs the delete packages scope and the read packages scope
		token: ''
		
```



```yaml
- uses: test
  with: 'hey'
```



# Scenarios

* [Delete a specific single version]

## Delete a single version

### Delete 



## Delete a specific single version by Id from a package hosted in the same repo that is executing the workflow





# License

The scripts and documentation in this project are released under the [MIT License](https://github.com/actions/delete-package-versions/blob/master/LICENSE)