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

.SH NAME
gt-pr-lock - Lock the conversation of a pull request


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


.SH DESCRIPTION
Lock the conversation of a pull request, so that only people with write access can comment on
it. One that is locked already is reported and keeps its reason.

.PP
Gitea does not check the reason: it offers Too heated, Off-topic, Resolved and Spam by default,
and administrators can change that.

.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

.SS JSON FIELDS
.EX
assignees, author, base, body, comments, created_at, draft, due_date, head,
head_remote_deleted, head_repo, head_sha, id, labels, merge_commit_sha,
mergeable, merged, merged_at, merged_by, milestone, number, review_decision,
reviewer_teams, reviewers, reviews, state, title, updated_at, url
.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 lock

.PP
\fB-r\fP, \fB--reason\fP=""
	Reason for locking, shown on the pull request, such as "Resolved"


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--csv\fP[=""]
	Output CSV with the specified comma-separated \fBfields\fR, or all fields

.PP
\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-q\fP, \fB--jq\fP=""
	Filter JSON output using a jq \fBexpression\fR; implies --json

.PP
\fB--json\fP[=""]
	Output JSON with the specified comma-separated \fBfields\fR, or all fields

.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--template\fP=""
	Format JSON output using a Go \fBtemplate\fR; implies --json (see gt help formatting)

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


.SH EXAMPLE
.EX
$ gt pr lock 13
$ gt pr lock 13 --reason "Too heated"
.EE


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