delete-workflow-runs-action

GitHub Action to delete workflow runs.

Usage

Inputs

Input	Required	Default	Description
token	false	${{ github.token }}	GitHub Token
include-disabled-workflows	false	true	Include disabled workflows
branch	false		Filter by branch
commit-sha	false		Filter by commit SHA
creation-date	false		Filter by creation date e.g. 2025-02-24T01:00:00Z
event	false		Filter by event e.g. pull_request
status	false		Filter by status e.g. cancelled
username	false		Filter by username
workflow	false		Filter by workflow filename e.g. ci.yml
keep	false	0	Keep last workflow runs [min=0, max=10]

For event, see Events that trigger workflows for the complete list.

For status, see List workflow runs for a repository API for all its supported values.

Permissions

The permissions actions: write are required to delete workflow runs. See Automatic token authentication for more details.

Examples

Assume that the required permissions are set:

permissions:
  actions: write

Delete all workflow runs

- uses: iamazeem/delete-workflow-runs-action@v1

Delete all workflow runs excluding the disabled ones

- uses: iamazeem/delete-workflow-runs-action@v1
  with:
    include-disabled-workflows: false

Delete all workflow runs except the last one

- uses: iamazeem/delete-workflow-runs-action@v1
  with:
    keep: 1

Contribute

Open an issue to report bugs or propose new features and enhancements.

PRs are always welcome. Please follow this workflow for submitting PRs:

• Fork the repo.
• Check out the latest main branch.
• Create a feature or bugfix branch from main.
• Commit and push changes to your forked repo.
• Make sure to add tests. See CI.
• Lint and fix Bash issues with shellcheck online or with vscode-shellcheck extension.
• Lint and fix README Markdown issues with vscode-markdownlint extension.
• Submit the PR.

License

MIT