March 14th, 2023

Github Actions: Delete all workflows runs

Deleting all workflows can be such a pain to do manually.

Github doesn't let us delete all workflows just with a few clicks. Instead we have to manually delete all the runs in order to remove an old workflow.

Below a script to automate the process via the Github API and gh-cli

# This script deletes all GitHub Actions runs for the current repository.
# It is useful for cleaning up the Actions tab after a large number of runs
# have been created, such as when testing a workflow.
# check for help flag (-h or --help)
if [[ $1 == "-h" || $1 == "--help" ]]; then
	echo "Usage: $0 [count]"
	echo "Deletes all GitHub Actions runs for the current repository."
	echo "The count argument is optional and defaults to 10."
	exit 0
# default limit value: 10
# parse limit value
if ! [[ $limit =~ ^[0-9]+$ ]]; then
	echo "Invalid limit value: $limit"
	exit 2
# transform $limit as number
limit=$(echo "$limit" | tr -d '[:space:]')
# check if gh is installed
if ! command -v gh &>/dev/null; then
	echo "gh could not be found. Please install it from"
	exit 1
# check if gh is authenticated
if ! gh auth status &>/dev/null; then
	echo "gh is not authenticated. Please run 'gh auth login' to authenticate."
	exit 1
repo=$(gh repo view --json nameWithOwner -q .nameWithOwner)
if [[ -z $repo ]]; then
	echo "No repository found."
	exit 1
runs=$(gh run list --limit "$limit" --json databaseId -q '.[].databaseId')
if [[ -z $runs ]]; then
	echo "No runs found."
	exit 0
total_runs=$(echo "$runs" | wc -l)
for run_id in $runs; do
	printf "\rDeleting run %d/%d with ID %s..." "$completed_runs" "$total_runs" "$run_id"
	gh api -X DELETE "repos/$repo/actions/runs/$run_id" --silent
printf "\nAll runs have been deleted"

I hope that this has been useful.

See you in the next one!

You might also like: