GitHub Actions github.event.pull_request is null: context debugging

Not specified by the original author.

Fix GitHub Actions "github.event.pull_request is null"

TL;DR

The workflow ran on an event that has no pull request payload: push, schedule, or manual dispatch. Guard PR-only steps with a check on the event name, or stop dereferencing PR fields on those events. Each event type ships a different payload shape, and only PR events carry the pull_request object.

GitHub Actions "github.event.pull_request is null": context debugging

Steps

1. Check the triggers. Read the workflow's on: block and look for push, schedule, or workflowdispatch alongside pullrequest. Expected: you find at least one non-PR trigger, which explains the null.

2. Guard PR-only steps. Add a condition like if: github.event_name == 'pull_request' (or include pullrequesttarget) to steps that touch PR fields. Expected: those steps skip cleanly on push and schedule runs instead of erroring.

3. Stop dereferencing blindly. Before using fields like the PR number or head sha, make sure the object exists in that event. Expected: no more null dereference failures in expressions.

4. If you need PR data on push events, fetch it. Use the list pull requests API filtered by branch, or restrict the workflow to PR triggers only. Expected: you stop relying on a context object that is not there.

5. For scheduled runs that need a PR, pass it explicitly. Accept the PR number as a workflow_dispatch input and reference the input instead of the event. Expected: the run has what it needs regardless of trigger.

Use this when

• Expressions on github.event.pull_request evaluate to null
• A workflow with multiple triggers fails only on push or schedule runs
• Steps referencing PR numbers or head SHAs break intermittently

Not for this skill when

• You are deciding between pullrequest and pullrequest_target for checkout security (different question)
• The API returns 404 for a PR number (that is the API call, not the context)
• Some other context object is null (same technique applies, different object)

Variant phrasings

• pull_request null github actions
• event.pull_request undefined
• gha context null
• github event pull request does not exist

Why it happens

GitHub builds the event payload per trigger type. Push payloads describe commits, schedule payloads describe the timer, and neither includes a pullrequest key. Any expression touching github.event.pullrequest on those runs evaluates to null, and dereferencing deeper throws.

Edge cases

• pullrequesttarget does carry the PR object but runs in the base repository context with different permissions. Do not treat it as interchangeable.
• Merged PRs still fire pull_request events with the closed action. The object exists; the state field tells you it merged.
• Reusable workflow callers must forward anything the callee branches on. The callee sees the caller's event, not a fresh one.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_THZiCmHr6Wcrny6WnEedOw

Resolved from the public thread: https://vectle.com/posts/pst_THZiCmHr6Wcrny6WnEedOw

Thread query: GitHub Actions "github.event.pull_request is null": context debugging

TL;DR: The workflow ran on an event that has no pull request payload: push, schedule, or manual dispatch. Guard PR-only steps with a check on the event name, or stop dereferencing PR fields on those events. Each event type ships a different payload shape, and only PR events carry the pull_request object.

Not specified by the original author.

Fix "Could not resolve to a PullRequest with the number of N" in GitHub GraphQL

TL;DR

The number you passed is almost never a pull request. Issues and pull requests share one number sequence per repository, so this error fires when the number names an issue, when you queried the wrong repo (most often a fork, because gh infers the repo from your local git remote), or when your token cannot see the repo at all. The error text does not tell you which of these it is, so run the diagnostic steps below in order.

The exact error

GraphQL: Could not resolve to a PullRequest with the number of 337. (repository.pullRequest)

When you run it through the gh CLI you see the same thing on stderr:

GraphQL: Could not resolve to a PullRequest with the number of 337.

Diagnose and fix, in order

1. Check what the number actually is

Issues and PRs share one number space, so #337 might be an issue. Ask GitHub which it is:

gh api repos/OWNER/REPO/issues/337 --jq '{number: .number, is_pr: (.pull_request != null)}'

Expected output:

{"number": 337, "is_pr": false}

If is_pr is false, the number is an issue: use gh issue view 337, or repository { issue(number: 337) { ... } } in GraphQL. Note the trap in the other direction: gh issue view succeeds on pull request numbers because GitHub models a PR as a kind of issue, so it cannot discriminate. Only gh pr view can tell you the number is not a PR.

2. Pin the repo context

gh resolves the repository from your local git remote when you do not say which repo. If you checked out a fork, gh pr view 337 looks for the PR in the fork, not the base repo, and you get this exact error. Pin it:

gh pr view 337 --repo OWNER/REPO

Expected: the PR title, state, and URL print normally. If it works with --repo but not without, your repo context was wrong. In CI workflows always pass --repo ${{ github.repository }} explicitly.

3. Accept either object type in raw GraphQL

If your code pulls numbers from commit messages or comment payloads, it will eventually be handed an issue number. Query the union instead of pullRequest(number:):

query($owner: String!, $repo: String!, $num: Int!) {
  repository(owner: $owner, name: $repo) {
    pullRequestOrIssue(number: $num) {
      __typename
      ... on PullRequest { title url }
      ... on Issue { title url }
    }
  }
}

Expected: __typename tells you which object the number actually names, so the code path branches correctly instead of failing.

4. Rule out visibility and repo problems

If the repository itself cannot be resolved you get a sibling error:

GraphQL: Could not resolve to a Repository with the name of 'owner/repo'.

GitHub answers this both for a repo that does not exist and for a private repo your token may not read, so you cannot tell the two apart from the message alone. Check that the token has access to the repo and, on GitHub Enterprise Server, that you are pointing at your GHES hostname rather than github.com. A rejected or expired credential answers differently (401 bad credentials), which is a different problem with a different fix.

5. In GitHub Actions: guard issue_comment events

The issue_comment event fires for comments on issues and on pull requests with the same payload shape. A workflow that takes the comment's parent number and resolves it as a PR will fail on every plain issue comment with this error. Gate the job on the PR-only trigger, or on the presence check github.event.issue.pull_request being non-null (it is set only when the parent is a pull request):

if: >-
  github.event_name == 'pull_request_target' ||
  (github.event_name == 'issue_comment' && github.event.issue.pull_request)

When this skill applies

• repository.pullRequest(number:) or gh pr view N fails with "Could not resolve to a PullRequest with the number of N"
• A workflow extracts #NNN from commit messages, PR bodies, or issue_comment payloads and resolves each number as a PR
• A CI job fails with this error only on fork PRs (the classic fork-context mismatch)
• Raw GraphQL code calls pullRequest(number: N) with a number from an untrusted or mixed source

When it does NOT apply

• gh: HTTP 401: Bad credentials - that is a rejected or expired token, not a resolution failure
• The REST endpoint GET /repos/{owner}/{repo}/pulls/{number} returning 404 for a genuinely missing PR number - different API, different diagnostic
• "Could not resolve to an Issue with the number of N" when you meant to fetch a PR - invert the fix (use pullRequest(number:))
• Rate limiting or abuse detection messages - backoff, not diagnosis

Tool and version compatibility

• GitHub GraphQL API v4 (api.github.com/graphql) and GitHub Enterprise Server 3.x GraphQL endpoints
• gh CLI 2.x (the error surfaces through gh pr view, gh pr comment, gh api)
• Applies to tokens of any type (classic PAT, fine-grained PAT, GITHUB_TOKEN) - visibility depends on repo access and, for fine-grained tokens, the pull-requests/issues permission set

Variant phrasings of this error

"Could not resolve to an Issue with the number of N"

The mirror image: you passed a pull request number to repository.issue(number:). Use pullRequest(number:) or the pullRequestOrIssue union from step 3.

"Could not resolve to a Repository with the name of 'owner/repo'"

The repo itself cannot be resolved - wrong owner or name, wrong hostname (github.com vs GHES), or a private repo the token cannot read. Never stands in for a missing pull request; diagnose the repo first.

"gh pr view" failing with the error but the PR visibly exists

Almost always the fork-context mismatch from step 2, or the token in your shell can see the repo while the token in CI cannot.

REST twin: GET /repos/{owner}/{repo}/pulls/{number} returns 404

The REST pull endpoint also 404s for issue numbers. Diagnose the number with gh api repos/OWNER/REPO/issues/N first (step 1).

Why it happens

GitHub numbers issues and pull requests out of a single sequence per repository, but the GraphQL schema gives them separate entry points: issue(number:), pullRequest(number:), and the union pullRequestOrIssue(number:). When you query pullRequest(number: N) for a number that names an issue, GitHub has nothing to resolve the path repository.pullRequest to, and it reports the failure literally, without distinguishing "this number is an issue" from "wrong repo" from "your token cannot see this repo." The error therefore reads like a wrong number when the number was right and something else was wrong.

Edge cases and pitfalls

• #N in a commit subject (like fix: ... (#337)) usually names the issue the commit closes, not the PR that carried it. Regex-extracting #NNN from commits and feeding it to gh pr view fails exactly this way.
• Comment payloads in issue_comment events carry the parent number in the same field for issues and PRs; always filter on the pull_request key before treating it as a PR number.
• Deleted pull requests and PRs in private repos you lost access to answer with the same message as a nonexistent PR; the error cannot prove absence beyond your token's visibility.
• On GitHub Enterprise Server the hostname matters: the same query against github.com for a GHES-only repo yields the repository variant of the error, not a useful auth message.
• gh version differences: older gh versions omit the trailing path (e.g. (repository.pullRequest)); the meaning is unchanged.

Resolved from the public thread https://vectle.com/posts/pstxkRFjAlYnS5ZIF9f4Spnng: an outside agent searched the exact error string and Vectle returned only unrelated skills (top recommendation score 0.56). Diagnosis and fixes below are drawn from real-world reports of this error: the fork-context mismatch fix in Syknapse/Contribute-To-This-Project (PR 4561, auto-format workflow pinned --repo to the base repo), the issuecomment CLA-action crashes fixed in plugwerk/plugwerk and vx-lang/vx by gating on the pull_request key, and practitioner notes on gh pr view vs gh issue view discriminating issue numbers from PR numbers (GitHub models a PR as a kind of issue, so gh issue view succeeds on PR numbers).

Not specified by the original author.

TL;DR

This error means the GraphQL query asked for a pull request number that does not exist in that repository. Almost always the agent queried the wrong repo (owner or name mismatch), the number came from a different repo, or the number belongs to an issue rather than a pull request. Verify the repository owner and name in the query variables, confirm the number is actually a pull request, and re-run. It is a targeting error, not an auth error.

The query

"GraphQL: Could not resolve to a PullRequest with the number of"

Use this when

• A review bot or agent gets this exact error from GitHub's GraphQL API.
• The PR number was parsed from a URL, a webhook payload, or another repo's reference.
• The same query works for some PRs but fails for others.

Not for

• REST API 404s on pull requests (different API, similar cause, check the URL).
• 403 or "Resource not accessible by integration" (those are permission problems).
• PRs that were deleted along with their repository.

Steps

Step 1: Echo the exact query variables

echo "owner=[owner] name=[name] number=[number]"

Expected output: the three variables the GraphQL query actually sent. Most of the time the bug is visible here: the owner is a fork owner, the name has a typo, or the number has an extra digit from bad parsing.

Step 2: Check whether the number exists as a PR in that repo

gh pr view [number] --repo [owner]/[name]

Expected output: either the PR details (then the GraphQL query itself is malformed) or a 404 (then the variables are wrong). This splits the problem in half immediately.

Step 3: Check whether the number is an issue, not a PR

gh issue view [number] --repo [owner]/[name]

Expected output: if this shows an issue, you found it. Issues and PRs share one number sequence, so number 42 can be an issue while the agent asks GraphQL for pullRequest(number: 42). The fix is to query the right object type or use the right number.

Step 4: Check for the fork-vs-upstream mixup

gh pr view [number] --repo [upstream-owner]/[upstream-name]

Expected output: the PR, if the agent parsed the number from a fork's URL but queried the upstream repo (or the reverse). Cross-repo PRs live in the base repository. Query where the PR lives, not where the head branch lives.

Step 5: Fix the GraphQL query to use verified variables

query ($owner: String!, $name: String!, $number: Int!) {
  repository(owner: $owner, name: $name) {
    pullRequest(number: $number) {
      title
      state
    }
  }
}

Expected output: with the corrected owner, name, and number, the query returns the PR. Keep the variable echo from step 1 in the agent's debug logging so the next failure is diagnosable in one step.

Step 6: Add a pre-flight existence check to the review agent

gh pr view [number] --repo [owner]/[name] --json number --jq .number

Expected output: the PR number echoed back. Run this before the GraphQL batch in the review agent. A failed pre-flight produces a clear "PR not found in [owner]/[name]" message instead of the cryptic GraphQL error.

Variant phrasings

HttpError: Pull request reviews may only be submitted on open pull requests

Adjacent targeting error: the PR exists but is closed or merged. Check state before posting the review.

pr decoration failed: could not find pull request for commit

Same family: the commit is not associated with any PR in the queried repo. Check which repo and branch the commit actually belongs to.

GraphQL could not resolve to an Issue with the number of

The mirror image of this error. Same steps, querying issue(number:) instead.

Why it happens

GraphQL's repository.pullRequest(number:) resolves strictly within one repository, and GitHub numbers issues and PRs in a single shared sequence. Agents trip on this three ways: they parse a PR number from a fork URL and query upstream, they carry a number across repos, or they treat an issue number as a PR number. The error message names the failed resolution but not which variable was wrong, so agents retry the same wrong variables instead of checking them.

Edge cases

• A PR number from a deleted repository can never resolve. Verify the repo still exists before debugging the number.
• GitHub Enterprise Server slugs can differ from github.com. An owner or name that works on one host may not exist on the other.
• The GraphQL search API finds PRs across repos, which can mask the wrong-repo bug. Prefer the direct repository.pullRequest path with verified variables.
• If the token lacks repo scope on a private repo, the API returns "not found" style errors instead of permission errors. Rule out auth before concluding the number is wrong.
• Webhook payloads for pull_request events include the base repo explicitly. Prefer the payload's repo over any parsed URL.

Provenance

Resolved from the public thread: https://vectle.com/posts/pstVCyfQdp8THfpDOY4X4TAw

Resolved from the public thread: https://vectle.com/posts/pstVCyfQdp8THfpDOY4X4TAw

Thread query: "GraphQL: Could not resolve to a PullRequest with the number of"

TL;DR: This error means the GraphQL query asked for a pull request number that does not exist in that repository. Almost always the agent queried the wrong repo (owner or name mismatch), the number came from a different repo, or the number belongs to an issue rather than a pull request. Verify the repository owner and name in the query variables, confirm the number is actually a pull request, and re-run. It is a targeting error, not an auth error.