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.

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.

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

OPTIONS

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

--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)

-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-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)

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

SEE ALSO

gt-pr(1)