GH-SECRET-DELETE(1)

πŸŽ€ GH-SECRET-DELETE(1) πŸŽ€

okay bestie, so this is the manual page for gh-secret-delete β€” it lives in the GitHub CLI manual and it's about to make secrets disappear ✨


✨ NAME ✨

gh-secret-delete β€” delete secrets. that's it. that's the whole vibe. πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

gh secret delete <secret-name> [flags]

πŸ’– DESCRIPTION πŸ’–

so you wanna delete a secret? iconic. but plot twist β€” secrets live at different levels, and you get to pick which one gets the axe. here's the whole lineup, no cap:

  • repository (this is the default): available to GitHub Actions runs, Agents sessions, or Dependabot in a repository
  • environment: available to GitHub Actions runs for a deployment environment in a repository
  • organization: available to GitHub Actions runs, Agents sessions, Dependabot, or Codespaces within an organization
  • user: available to Codespaces for your user

pick your fighter 🫢


πŸ”₯ OPTIONS πŸ”₯

  • -a, --app <string> β€” delete a secret for a specific application. the valid values are {actions|agents|codespaces|dependabot}, so like, choose wisely πŸ’€
  • -e, --env <string> β€” delete a secret for an environment
  • -o, --org <string> β€” delete a secret for an organization
  • -u, --user β€” delete a secret for your user

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • -R, --repo <[HOST/]OWNER/REPO> β€” select another repository using the [HOST/]OWNER/REPO format. it's giving "borrowed from the parent command" energy but we love it anyway 🧚

⭐ ALIASES ⭐

gh secret remove

same thing, different name β€” iykyk 😌


πŸ’œ 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. fr fr, don't @ me if you get a weird one πŸ’€

🌸 SEE ALSO 🌸

gh-secret(1) β€” go check out the whole secret family, they're all main characters tbh πŸ‘‘


<div align="center">πŸ’– πŸŽ€ πŸ’–</div>

and that's the tea, bestie πŸ“ this icon was brought to you by GitHub CLI v2.102.0, dated Oct 2026 β€” yeah she's from the future, slay πŸ’…βœ¨

πŸ“¦ where this page comes from