A GitHub action that determines if a release exists in a repo.

If a release is found it will additionally return information about it such as:

• Pre-release status
• Draft status
• Name
• Url

Additionally see: tag-exists-action

Required - Tag to search a matching release for.

Optional - Repo you'd like to search, in owner/repo-name format.

A string value of 'true' or 'false'

A string value of 'true' or 'false'

A string value of 'true' or 'false'

If found, the name of the release.

If found, the url of the release.

To check if a release with the tag v1.0 exists in your repo:

- uses: mukunku/release-exists-action@v1.1.0
  id: check-release
  with: 
    tag: 'v1.0'

- run: echo "Release exists!"
  if: steps.check-release.outputs.exists == 'true' 

To check if a non-draft release with the tag v1.0.0 exists in the repo actions/checkout:

- uses: mukunku/release-exists-action@v1.1.0
  id: check-release
  with: 
    tag: 'v1.0.0'
    repo: 'actions/checkout'

- run: | 
    echo "Release exists and is not a draft!"
    echo "${{ steps.check-release.outputs.name }}"
    echo "${{ steps.check-release.outputs.url }}"
    echo "${{ steps.check-release.outputs.prerelease }}"
  if: steps.check-release.outputs.exists == 'true' && steps.check-release.outputs.draft == 'false'

This action uses the ${{github.token}} secret to automatically inject your access token. If you'd like to provide your own token instead check out this help article.