← All permissions
Repository permission·pull_requests:read
Pull requests: Read
Tier 3 · Low
Why Tier 3
Reads pull requests and reviews.
Data plane permissions start at Tier 2. This one is lowered for the reason above.
- Target
- Repository
- Plane
- DataCode: Repository contents, branches, tags, pull requests, checks and commit signing keys.
- Granted by
- Fine-grained PAT, GitHub App, GITHUB_TOKEN
- Available on
- Every setup
- In a workflow
permissions: pull-requests: read
What it unlocks
32 REST endpoints need this permission. A few of them:
- GET /repos/{owner}/{repo}/commits/{commit_sha}/pulls
- GET /repos/{owner}/{repo}/pulls
- GET /repos/{owner}/{repo}/pulls/comments
- GET /repos/{owner}/{repo}/pulls/comments/{comment_id}
Roles that include it
No built-in role includes it. Only tokens, Apps or custom roles can grant it.
Classic scopes that reach it
No classic scope reaches it. Only fine-grained PATs, Apps or GITHUB_TOKEN can grant it.
Attack paths
No attack technique, escalation or incident on ghtier goes through this yet.