GH-PROJECT-ITEM-DELETE(1)

💅 gh-project-item-delete — the girlies are deleting project items

okay so bestie, real talk: this is the gh project item-delete manual page from the GitHub CLI manual, and it does exactly one thing — it deletes an item from a project by ID. That's it. That's the whole vibe. ✨

Think of it as the "blocked and reported" button but for project items, except instead of drama you get a cleaner project board. We love a glow-up. 🫶

---

🌸 NAME

gh-project-item-delete — Delete an item from a project by ID 🗑️✨

✨ SYNOPSIS

gh project item-delete [<number>] [flags]

so yeah, you can optionally pass the project number, plus whatever flags you need. [<number>] is in brackets because it's optional, bestie — not because we're being mysterious. 💅

🎀 OPTIONS

okay this is the part where we go through every single flag, no skipping, no cap:

• --format <string> — tells it what format to spit the output out in. the only listed option here is {json}, and honestly? iconic choice. 🌈
• --id <string> — the ID of the item to delete. this is the main character of the whole command ngl, it's the thing you're yeeting. 🎯
• -q, --jq <expression> — filters the JSON output using a jq expression. so you get exactly the slice of JSON you wanted, no filler. obsessed. 🍓
• --owner <string> — the login of the owner. and yes, you can literally just type "@me" for the current user, which is lowkey the most convenient thing ever. 🫶
• -t, --template <string> — formats the JSON output using a Go template. the manpage says to see "gh help formatting" for the deets, so go look at that if you want the full tutorial. 📖✨

💀 EXIT CODES

so when the command finishes, it tells you how it went. vibe check via numbers:

• 0: Successful execution — slay, it worked. 🎉
• 1: Error — something went wrong, sad girl hours. 😭
• 2: Command canceled — you (or something) bailed on it. 🙈
• 4: Authentication required — you gotta log in first, bestie. 🔐

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. 👀 (so like, don't come for me if there's more — check the command's own help, fr fr.)

🌟 EXAMPLE

here's the actual example, copied exactly, because I would never mess with your code:

# Delete an item in the current user's project "1"
$ gh project item-delete 1 --owner "@me" --id <item-id>

see how it's deleting an item in the current user's project "1"? project number 1, owner "@me", and the --id is the item you're deleting. chef's kiss. 👑 except we're deleting, not cooking. 🧚

🦋 SEE ALSO

• gh-project(1) — the parent project page, go say hi. 💖

---

and that's the whole page, bestie — no notes, it ate. 💅

🐚 cute lil sign-off: this page is from GitHub CLI v2.102.0, dated Oct 2026. go forth and delete responsibly. 🎀✨