---
name: "gh-cache-delete"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-cache-delete"
---

# gh-cache-delete(1)

Delete GitHub Actions caches

## NAME

gh-cache-delete - Delete GitHub Actions caches

## SYNOPSIS

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

## DESCRIPTION

Delete GitHub Actions caches.

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

## OPTIONS

- **-a**, **--all**

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

- **-r**, **--ref** **\<string\>**

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

- **--succeed-on-no-caches** **\<--all\>**

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

## OPTIONS INHERITED FROM PARENT COMMANDS

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

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

## 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

```
# 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

**[gh-cache(1)](/gh-cache/1.md)**