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

GitHub：自動マージが断られた理由

自動マージは、必須のレビューとステータスチェックが通ったら GitHub が自分でプルリクをマージする仕組みです。GraphQL の enablePullRequestAutoMerge で入れます。渡すのはプルリクの id と、必要なら mergeMethod・commitHeadline・commitBody・authorEmail・expectedHeadOid（そうだと思う先頭）です。断りの文は GitHub の文書にありません。以下は公開の報告から引いた文と、その裏にある GitHub の文書の決まりです（2026年10月25日に確認）。

mutation {
  enablePullRequestAutoMerge(input: {pullRequestId: "PR_…", mergeMethod: SQUASH}) {
    clientMutationId
  }
}

GitHub の文と理由

Pull request Pull request is in clean status（GitHub は「Pull request」を2回書きます）：プルリクは今すぐマージできます。GitHub の文書は、自動マージを出すのは今すぐマージできないプルリクだけ、たとえばブランチのルールがレビューやステータスチェックを待っているときだ、と書いています。GitHub のスキーマでは CLEAN は「マージでき、コミットのステータスも通っている」です。
Pull request Pull request is in unstable status：UNSTABLE は「マージできるが、コミットのステータスが通っていない」です。落ちているチェックはあっても、ルールが必須にしているものではないので今すぐマージでき、自動マージが待つ物がありません。
Auto merge is not allowed for this repository：リポジトリの Allow auto-merge の設定が切れています。GitHub の文書では、自動マージはまずリポジトリで許す必要があります。マージキューが必須のブランチには、この設定はかからず、リポジトリが許していなくても Merge when ready で自動マージが入ります。
Pull request Protected branch rules not configured for this branch：マージ先のブランチに、マージを止めるルールがありません。待つ物が無いということです。公開の報告の1件は、マージ先のブランチに Require a pull request before merging などのルールを足して解消しています。
Resource not accessible by integration（ワークフローの GITHUB_TOKEN から）：公開の報告では、pull-requests: write だけでは足りず、contents: write を足すと自動マージを入れられました。
だれが入れられるか：GitHub の文書は、リポジトリへの書き込みの権限がある人が自動マージを入れられると書いています。

入れたのに外れる

GitHub の文書は、書き込みの権限の無い人が head のブランチに push したときと、マージ先のブランチが変えられたときに、自動マージが外れると書いています。
外せるのは、書き込みの権限のある人と、プルリクを作った人です。
マージキューが必須のブランチでは、GitHub のスキーマによると、渡したマージの方法とコミットメッセージは使われません。

直し方

clean・unstable：今マージするか、気になるチェックを先に待ちます。
リポジトリで許されていない：リポジトリの Settings → General → Pull Requests で Allow auto-merge を選びます。
ブランチにルールが無い：マージ先のブランチに、レビューかステータスチェックを必須にするルールを足すか、準備ができたら自分でマージします。
ワークフロー：ジョブに contents: write と pull-requests: write を与えます。
自動マージでなくマージが断られたなら：GitHub がマージを断った理由へ。

IntelliJ IDEA に自動マージは無く、Merge… は今すぐマージできるときに押せる

IntelliJ IDEA に入っている GitHub の機能が、まだマージできないプルリクをどう扱うか。ソース（2026年10月31日に確認・IntelliJ IDEA：GraphQL のファイル・GithubApiRequests.kt・GHPullRequestMergeStateStatus.kt・GHPRMergeabilityStateBuilder.kt・GHPRReviewFlowViewModelImpl.kt）では：

自動マージは無い：78本の GraphQL のファイル（うち20本は mutation）にも、REST の問い合わせにも、自動マージは出てきません。そのため IDE は自動マージを入れも外しもせず、入っているかも読みません。それは GitHub で行います。
Merge… と Squash and Merge… が押せるとき：GitHub の mergeStateStatus が CLEAN・HAS_HOOKS・UNSTABLE のとき、つまり今すぐマージできるときで、上で GitHub が自動マージを断る clean と unstable もここに入ります。BLOCKED か BEHIND の間はAdmin の権限のアカウントで、かつ GitHub が向き先のブランチのルールを返しているときだけ押せ、マージはその場で送ります（ルールがそろうまで待つのではありません）。ほかの状態では押せないので、IDE にはレビューやチェックを待つ物がありません。ボタンのほかの条件はRebase and merge が使えないにあります。

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

Lesstep の Pull Request Inbox for GitHub は、JetBrains IDE（2024.1 以降）のプラグインです。マージのダイアログの「要件を満たしたら自動でマージ」は、GitHub がマージを止めている間（ブランチのルールがまだ満たされていないか、マージ先に新しいコミットがあるとき）だけ出し、リポジトリが自動マージを切っているときは出しません。今すぐマージできるプルリクには、マージそのものを出します。自動マージはダイアログのマージの方法とコミットメッセージで入れ、要件を満たしたらマージされると言います。GitHub が断ったときは GitHub の文をそのまま出し、権限の足りないトークンなら設定を案内します。受信箱・差分・会話は無料、承認・コメント・マージは Pro（月 US$1.50・30日間の無料試用つき）です。画面は日本語です。

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