.nh
.TH "GT-PR-DELETE" "1" "Nov 2026" "gitea-cli" "gitea-cli Manual"

.SH NAME
gt-pr-delete - Delete a pull request


.SH SYNOPSIS
\fBgt pr delete [<number> | <url> | <branch>] [flags]\fP


.SH DESCRIPTION
Delete a pull request for good, with its comments, reviews and attachments. This cannot be
undone and needs the permission to delete issues, which Gitea gives repository owners and
administrators. The head and base branches stay. To only stop work on it, use gt pr close.
A branch names only an open pull request: give the number of a closed or merged one.
Issues are not deleted by this command: see gt issue delete.

.SS ARGUMENTS
.EX
A pull request can be supplied as argument in any of the following formats:
- by number, such as "13" or "#13"
- by URL, such as "https://gitea.com/OWNER/REPO/pulls/13"
- by the name of its head branch, such as "feature/login" or "bob:feature/login"; a branch that
  reads as OWNER/REPO#N, such as "fix/login#2", needs the OWNER:BRANCH form

Without an argument, the pull request of the current branch is selected.
.EE


.SH OPTIONS
\fB--dry-run\fP[=false]
	Show the write requests gt would send, without sending them

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for delete


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--cwd\fP=""
	Working \fBdirectory\fR for repository discovery

.PP
\fB--debug\fP[=false]
	Log the method, URL, status, and duration of each HTTP request to stderr

.PP
\fB--host\fP=""
	Gitea instance \fBURL\fR, including any base path

.PP
\fB--interactive\fP[=false]
	Allow prompts with machine output

.PP
\fB--no-input\fP[=false]
	Disable prompts and implicit editor/browser interactions

.PP
\fB--remote\fP=""
	Git \fBremote\fR used for repository discovery

.PP
\fB-R\fP, \fB--repo\fP=""
	Select a repository as \fBOWNER/REPO\fR or URL

.PP
\fB--sudo\fP=""
	Perform API requests as this \fBuser\fR (requires an administrator account)

.PP
\fB--user\fP=""
	Account \fBname\fR on the selected instance

.PP
\fB-y\fP, \fB--yes\fP[=false]
	Accept confirmations without prompting


.SH EXAMPLE
.EX
$ gt pr delete 13
$ gt pr delete 13 --yes
.EE


.SH SEE ALSO
\fBgt-pr(1)\fP