mattraks/Delete Workflow Runs
GitHub Action to delete workflow runs in a repository.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jun 5, 2026
- License
- MIT
Pinned Snippet
uses: mattraks/delete-workflow-runs@b3018382ca039b53d238908238bd35d1fb14f8ee # v2.1.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| token | GitHub authentication token | no | ${{ github.token }} |
| baseUrl | GitHub API base URL (for GitHub Enterprise) | no | https://api.github.com |
| repository | Repository name in {owner}/{repo} format | no | ${{ github.repository }} |
| retain_days | Number of days to retain workflow runs | no | 30 |
| keep_minimum_runs | Minimum number of runs to keep per workflow (or per day if use_daily_retention is true) | no | 6 |
| use_daily_retention | If true, keep_minimum_runs will be applied per day instead of overall | no | false |
| delete_workflow_pattern | Workflow name or filename pattern (omit for all) | no | — |
| delete_workflow_by_state_pattern | Workflow states to target (comma-separated or ALL) | no | ALL |
| delete_run_by_conclusion_pattern | Run conclusions to target (comma-separated or ALL) | no | ALL |
| dry_run | Simulate deletions without performing them | no | false |
| check_branch_existence | Skip runs from existing branches (excludes main) | no | false |
| check_pullrequest_exist | Skip runs linked to pull requests | no | false |
Outputs
no outputs