GitHub・プルリク・REST API・2026年10月25日に確認

GitHub：ブランチの更新が断られた理由

GitHub の REST API での「Update branch」は PUT /repos/持ち主/リポジトリ名/pulls/番号/update-branch で、マージ先のブランチの先頭をプルリクのブランチにマージします。expected_head_sha は省けます。ブランチの先頭がこれだと思うコミットで、GitHub の文書では、合わないと 422 になります。文書が挙げる答えは、受け付けたときの 202、403、検証に通らないか送りすぎたときの 422 です。422 の文は文書にありません。以下は公開の報告から引いた文と、その裏にある GitHub の文書の決まりです（2026年10月25日に確認）。

PUT /repos/持ち主/リポジトリ名/pulls/番号/update-branch

{"expected_head_sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e"}

422：GitHub の文と理由

merge conflict between base and head：マージ先の新しいコミットがプルリクのブランチと衝突していて、GitHub が取り込めません。GitHub の文書では、プルリクのページからブランチを更新できるのは、マージの衝突が無く、マージ先より遅れているときです。衝突は先に解きます。
There are no new commits on the base branch.：プルリクのブランチがマージ先のコミットをすでに全部持っていて、マージする物がありません。公開の報告では、この答えを「すでに最新」として扱っています。
expected head sha didn't match current head ref：expected_head_sha がもうブランチの先頭ではありません。見た後に、だれかがブランチに push しました。expected_head_sha を付けなければ、GitHub はブランチの今の先頭を使います。

403・404

403 Resource not accessible by personal access token（または by integration）：GitHub の権限の一覧では、この入口は Fine-grained のトークンの Pull requests の書き込みです（足す権限へ）。GitHub App として送るときは、head のリポジトリの中身（contents）の書き込みも要ります。
保護された head のブランチ：GitHub の文書は、プルリクの head のブランチが保護されたブランチだと、Update branch を使えないことがあると書いています。
404：リポジトリかプルリクが、このトークンからは見えません。トークンで見えない非公開のリポジトリにも、GitHub はこう答えます。

202：受け付けた

GitHub は 202 Accepted と、message と url を返します。頼みを受け付けたという意味で、マージのコミットはその後でブランチに入ります。プルリクを読み直すと、そのコミットが見えます。REST API での更新はいつもマージのコミットで、プルリクのページには Update with rebase もあります。

直し方

マージの衝突：手元でマージ先のブランチをプルリクのブランチにマージし（git fetch origin、git switch head のブランチ、git merge origin/マージ先）、衝突を解いてコミットし、push します。
新しいコミットが無い：することはありません。プルリクを読み直します。
先頭が動いた：プルリクを読み直して新しいコミットを見てから、新しい先頭を expected_head_sha にしてもう一度更新します。
403：トークンに Pull requests の書き込みを足すか、ブランチに push できる人に頼みます。

IntelliJ IDEA で GitHub のプルリクを見るなら

Lesstep の Pull Request Inbox for GitHub は、JetBrains IDE（2024.1 以降）のプラグインです。「ブランチを更新」は、マージ先にプルリクがまだ持っていないコミットがあり、両者が衝突していないときだけ、プルリクのページに出ます。画面に出ていた先頭のコミットを expected_head_sha として送るので、見ていないコミットの上からブランチが更新されることはありません。202 なら、マージ先の新しいコミットを GitHub がブランチに取り込んでいると言って、プルリクを読み直します。GitHub が断ったときは GitHub の文をそのまま出します。受信箱・差分・会話は無料、承認・コメント・マージは Pro（月 US$1.50・30日間の無料試用つき）です。画面は日本語です。

GitHub は GitHub, Inc. の商標、IntelliJ IDEA は JetBrains s.r.o. の商標です。このページは GitHub, Inc.・JetBrains のいずれとも提携しておらず、承認も受けていません。