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

GitHub：下書き・レビュー準備完了・閉じるが断られた理由

GitHub の REST でプルリクを変える PATCH /repos/持ち主/リポジトリ名/pulls/番号 が受け取るのは title・body・state（open か closed）・base・maintainer_can_modify で、下書きの欄はありません。閉じるのはここで、下書きに戻す・レビューできる状態にするのは GraphQL の convertPullRequestToDraft と markPullRequestReadyForReview で、プルリクの id を渡します。PATCH の答えとして文書にあるのは 200、403、検証に通らないか送りすぎたときの 422 です。以下は公開の報告から引いた断りと、その裏にある GitHub の文書の決まりです（2026年10月25日に確認）。

mutation {
  markPullRequestReadyForReview(input: {pullRequestId: "PR_…"}) {
    pullRequest { isDraft }
  }
}

GitHub の文と理由

Resource not accessible by integration (convertPullRequestToDraft) または (markPullRequestReadyForReview)（ワークフローの GITHUB_TOKEN から）：公開の報告では、pull-requests: write だけでは断られ、contents: write を足すと同じコマンドが通りました。別の報告では、フォークからのプルリクで動いたワークフローのトークンは読み取りだけになり、やはり断られました。
Resource not accessible by personal access token（FORBIDDEN）：公開の報告では、Pull requests の読み書きを持つ Fine-grained のトークンでも同じく断られ、classic のトークンでは同じプルリクを下書きに戻せました。
閉じるのは要る物が少なく済みます。公開の報告では、contents: read と pull-requests: write のワークフローのトークンが、下書きに戻すのは断られ、閉じるのは通りました。GitHub の権限の一覧では、PATCH は Fine-grained のトークンの Pull requests の書き込みです。
役割：GitHub のリポジトリの役割の表では、下書きをレビューできる状態にする・プルリクを下書きに戻すのは Write 以上、どのプルリクでも閉じる・開き直すのは Triage 以上です。
プラン：GitHub の文書では、下書きが使えるのは、GitHub Free・GitHub Free for organizations・GitHub Pro・旧来のリポジトリ単位のプランの公開リポジトリと、GitHub Team・GitHub Enterprise Cloud の公開・非公開のリポジトリです。GitHub Free や GitHub Pro の非公開リポジトリには、戻す先の下書きがありません。
だれが変えられるか：PATCH の文書は、公開リポジトリのプルリクを変えるには head か元のブランチへの書き込みの権限が要り、組織が持つリポジトリではその組織のメンバーでなければならないと書いています。

通ったら変わること

GitHub の文書は、レビューできる状態にするとコードオーナーにレビューを頼む、と書いています。
下書きに戻すと、レビューできる状態に戻すまでだれもマージできません。通知を受けている人は、そのまま受け続けます。
閉じたプルリクは state を open にして開き直せます。

直し方

ワークフロー：ジョブに pull-requests: write に加えて contents: write を与えます。
Fine-grained のトークン：Pull requests に加えて Contents にも書き込みを与えるか、repo のスコープの classic のトークンを使います（足す権限へ）。
役割：人のプルリクの段階を変えるなら Write、閉じるなら Triage の役割を頼みます。
プランに下書きが無い：プルリクは開いたままにして、まだ準備ができていないと本文に書きます。
下書きだからとマージが断られたなら：先にレビューできる状態にします（GitHub がマージを断った理由へ）。

IntelliJ IDEA では下書きに Post Pull Request しか出ず、下書きへは戻せない

IntelliJ IDEA に入っている GitHub の機能が、プルリクの段階をどう変えるか。ソース（2026年10月31日に確認・IntelliJ IDEA：GHPRDetailsActionsComponentFactory.kt・CodeReviewDetailsActionsComponentFactory.kt・GHPRPostReviewAction.kt・GHPRCloseAction.kt・GHPRReviewFlowViewModelImpl.kt・GHPRDetailsServiceImpl.kt・GHGQLRequests.kt）では：

出す操作：下書きのプルリクに出るボタンは Post Pull Request だけで、これでレビュー準備完了にします（GraphQL の markPullRequestReadyForReview）。下書きの間は、そこで閉じることもマージもできません。開いているプルリクでは Close Pull Request が「その他の操作」のメニューの中にあり、閉じたプルリクに出るボタンは Reopen Pull Request だけです。閉じると開き直すは、上の REST の PATCH に state を付けて送ります。
押せる人：3つとも、プルリクの作者か、Triage 以上の権限のアカウントのときだけ押せます（権限は IDE がリポジトリにつないだ時に GitHub が返した物）。そのため Triage のアカウントには他人の下書きでも Post Pull Request が出ますが、上の GitHub の表ではレビュー準備完了にするのは Write からです。
下書きに戻す操作はありません：ソースには markPullRequestReadyForReview のリクエストはあっても、convertPullRequestToDraft はありません。下書きに戻すのは GitHub で行います。
GitHub が断ると、画面には何も出ません。ソースはエラーを IDE のログに書くだけで、画面に出すのは「これから」と書かれています。その後プルリクを読み直すので、ボタンは GitHub での今の状態に合わせて変わります。

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

Lesstep の Pull Request Inbox for GitHub は、JetBrains IDE（2024.1 以降）のプラグインです。下書きには「レビュー準備完了にする」を、自分が作ったプルリクには「下書きに戻す」を出します。「閉じる」は先に確かめ、GitHub で開き直せると言います。終わったら、何が変わったかを言います。GitHub が断ったときは GitHub の文をそのまま出し、権限の足りないトークンならそう言って設定を案内します。設定では Pull requests と Contents の書き込みを頼みます。受信箱・差分・会話は無料、承認・コメント・下書き・閉じる・マージは Pro（月 US$1.50・30日間の無料試用つき）です。画面は日本語です。

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