GH-CACHE-DELETE(1) GitHub CLI manual GH-CACHE-DELETE(1)

# [NAME](#NAME)

gh-cache-delete - Delete GitHub Actions caches

# [SYNOPSIS](#SYNOPSIS)

**gh cache delete \[<cache-id> | <cache-key> | --all] \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Delete GitHub Actions caches.

Deletion requires authorization with the **repo** scope.

# [OPTIONS](#OPTIONS)

[**-a**, **--all**](#a)

Delete all caches, can be used with --ref to delete all caches for a specific ref

[**-r**, **--ref** **<string>**](#r)

Delete by cache key and ref, formatted as refs/heads/ or refs/pull//merge

[**--succeed-on-no-caches** **<--all>**](#succeed_on_no_caches)

Return exit code 0 if no caches found. Must be used in conjunction with --all

# [OPTIONS INHERITED FROM PARENT COMMANDS](#OPTIONS_INHERITED_FROM_PARENT_COMMANDS)

[**-R**, **--repo** **<\[HOST/\]OWNER/REPO>**](#R)

Select another repository using the \[HOST/]OWNER/REPO format

# [EXIT CODES](#EXIT_CODES)

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

# [EXAMPLE](#EXAMPLE)

```
# Delete a cache by id
$ gh cache delete 1234
# Delete a cache by key
$ gh cache delete cache-key
# Delete a cache by id in a specific repo
$ gh cache delete 1234 --repo cli/cli
# Delete a cache by key and branch ref
$ gh cache delete cache-key --ref refs/heads/feature-branch
# Delete a cache by key and PR ref
$ gh cache delete cache-key --ref refs/pull/<PR-number>/merge
# Delete all caches (exit code 1 on no caches)
$ gh cache delete --all
# Delete all caches for a specific ref
$ gh cache delete --all --ref refs/pull/<PR-number>/merge
# Delete all caches (exit code 0 on no caches)
$ gh cache delete --all --succeed-on-no-caches
```

# [SEE ALSO](#SEE_ALSO)

[**gh-cache(1)**](/man/os/gh/gh-cache.1)

Oct 2026

---

Document: gh-cache-delete(1) from gh 2.102.0-r1 (Chainguard OS)
Source: https://github.com/cli/cli