GH-RUN-DELETE(1)

💅 GH-RUN-DELETE(1) — the GitHub CLI manual, bestie edition 🎀

okay so. you're on the GitHub CLI manual page for GH-RUN-DELETE(1) and honestly? it's giving "cleanup era." ✨ This is the little command that deletes a workflow run. That's it. That's the whole vibe. No cap.

---

🌸 NAME 🌸

gh-run-delete — delete a workflow run 💀🔥

✨ SYNOPSIS ✨

gh run delete [<run-id>] [flags]

literally just that. run-id is optional, which means you can let the command ask you which run you wanna yeet. icon behavior.

🦋 OPTIONS INHERITED FROM PARENT COMMANDS 🦋

These aren't even this command's options, they're handed down from the parent, like a really useful family heirloom 🫶

• -R, --repo <[HOST/]OWNER/REPO> — pick a different repository using the [HOST/]OWNER/REPO format. so you can point at some other repo without leaving the command. lowkey so convenient.

👑 EXIT CODES 👑

the receipts, bestie. memorize them iykyk:

• 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. (not me telling you to read another help page… but yeah, check it.)

🌈 EXAMPLE 🌈

okay the good part. actual examples, fr fr:

# Interactively select a run to delete
$ gh run delete

# Delete a specific run
$ gh run delete 12345

first one: no args, so it picks interactively — very main character of it. second one: you already know the run id, you're being decisive, you slayed. 💅

💜 SEE ALSO 💜

• gh-run(1) — go read the parent page, it's the whole run family tree 🌳

---

and that's the whole page!! 🧚 this little gem is from GitHub CLI v2.102.0, dated Oct 2026 — stan a stable release. bye bestie, go delete responsibly 🍓💖