gh cache delete can delete all caches for a ref

Introduced 2026-01-21 · score 0.98

HOW TO USE IT

When deleting all GitHub Actions caches for a ref, run `gh cache delete --all --ref <ref>`; use a fully qualified branch or pull request ref.

WHY THIS HELPS

Delete all GitHub Actions caches associated with a ref.

REQUIREMENTS AND LIMITATIONS

• Version: v2.86.0
• --all (required): Delete all caches; combine with `--ref` to target one ref.
• --ref <string> (required): Target a ref formatted as `refs/heads/<branch name>` or `refs/pull/<number>/merge`.
• Prerequisite: Deletion requires authorization with the `repo` scope.

FIRST-PARTY EVIDENCE

• https://github.com/cli/cli/releases/tag/v2.86.0
• https://cli.github.com/manual/gh_cache_delete

Check the installed version and the source before using it. Entry JSON

Report a problem with this card