Skip to content

delete-workflow-runs-action

Actions
GitHub Action to delete workflow runs
v1
Latest
Star (2)

Tags

 (1)

delete-workflow-runs-action

CI License: MIT GitHub release (latest by date)

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

delete-workflow-runs-action is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

GitHub Action to delete workflow runs
v1
Latest

Tags

 (1)

delete-workflow-runs-action is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.