GT-PR-EDIT(1)                  gitea-cli Manual                  GT-PR-EDIT(1)



NAME
       gt-pr-edit - Edit a pull request



SYNOPSIS
       gt pr edit [<number> | <url> | <branch>] [flags]



DESCRIPTION
       Edit the title, body, base branch, reviewers, labels, assignees,
       milestone or due date of a pull request, or mark it as a draft or ready
       for review. Without flags on a terminal, a form edits the title, base
       branch, body, assignees, milestone, labels and due date, starting from
       their current values, and sends only what changed.


       Gitea changes the milestone, assignees and due date only for people who
       can write to the pull requests of the repository, and leaves them as
       they were for the author of a pull request who cannot: gt then names
       the flags or form fields it left out and fails. Gitea refuses their
       label changes outright, so gt sends the other changes first.


       --add-blocked-by and --remove-blocked-by change which issues or pull
       requests must be done first, --add-blocks and --remove-blocks which
       ones wait for this pull request; the same flags of gt issue edit work
       on issues. The blocked_by and blocks JSON fields cost extra requests,
       made only when the output includes them.


   ARGUMENTS
       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.


   JSON FIELDS
       assignees, author, base, blocked_by, blocks, 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



OPTIONS
       --add-assignee=[]   Add assignees by login; @me for yourself


       --add-blocked-by=[]      Mark the pull request as blocked by other
       issues: N, #N, OWNER/REPO#N or a URL


       --add-blocks=[]     Mark the pull request as blocking other issues: N,
       #N, OWNER/REPO#N or a URL


       --add-label=[]      Add labels by name; prefix repo: or org: to
       disambiguate


       --add-project=[]    Add the pull request to the project with this ID or
       title, a number being an ID first (repeatable)


       --add-reviewer=[]   Request reviews from users; @me for yourself


       --add-reviewer-team=[]   Request reviews from teams of the repository's
       organization


       --allow-maintainer-edit[=false]    Allow maintainers to push to the
       head branch


       -B, --base=""  Base branch


       -b, --body=""  Pull request body (empty clears)


       -F, --body-file=""  Read the body from file, or - for stdin


       --deadline=""  Due date: YYYY-MM-DD, RFC3339 or Unix timestamp; only
       the date counts, as the end of that day in UTC; empty clears it


       --draft[=false]     Mark the pull request as a draft (same as gt pr
       ready --undo)


       --dry-run[=false]   Show the write requests gt would send, without
       sending them


       -e, --editor[=false]     Edit the current body in your editor


       -h, --help[=false]  help for edit


       -m, --milestone=""  Milestone title or ID; 0 removes it


       --ready[=false]     Mark the pull request as ready for review (same as
       gt pr ready)


       --remove-assignee=[]     Remove assignees by login; @me for yourself


       --remove-blocked-by=[]   Lift the dependency of the pull request on
       other issues: N, #N, OWNER/REPO#N or a URL


       --remove-blocks=[]  Stop the pull request from blocking other issues:
       N, #N, OWNER/REPO#N or a URL


       --remove-label=[]   Remove labels by name


       --remove-milestone[=false]    Remove the milestone


       --remove-project=[]      Take the pull request off the project with
       this ID or title, a number being an ID first (repeatable)


       --remove-reviewer=[]     Withdraw review requests from users


       --remove-reviewer-team=[]     Withdraw review requests from teams


       --set-assignees=[]  Replace all assignees; an empty value clears them


       --set-labels=[]     Replace all labels; an empty value clears them


       -t, --title=""      Pull request title



OPTIONS INHERITED FROM PARENT COMMANDS
       --csv[=""]     Output CSV with the specified comma-separated fields, or
       all fields


       --cwd=""  Working directory for repository discovery


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


       --host=""      Gitea instance URL, including any base path


       --interactive[=false]    Allow prompts with machine output


       -q, --jq=""    Filter JSON output using a jq expression; implies --json


       --json[=""]    Output JSON with the specified comma-separated fields,
       or all fields


       --no-input[=false]  Disable prompts and implicit editor/browser
       interactions


       --remote=""    Git remote used for repository discovery


       -R, --repo=""  Select a repository as OWNER/REPO or URL


       --sudo=""      Perform API requests as this user (requires an
       administrator account)


       --template=""  Format JSON output using a Go template; implies --json
       (see gt help formatting)


       --user=""      Account name on the selected instance



EXAMPLE
       $ gt pr edit 13 --title "Add login support" --add-reviewer carol
       $ gt pr edit --base develop
       $ gt pr edit 13 --editor
       $ gt pr edit 13 --add-blocked-by 9 --remove-blocks 20



SEE ALSO
       gt-pr(1)

gitea-cli                          Nov 2026                      GT-PR-EDIT(1)