REST API endpoints for review requests

Use the REST API to interact with review requests.

About review requests

Pull request authors and repository owners and collaborators can request a pull request review from anyone with write access to the repository. Each requested reviewer will receive a notification asking them to review the pull request.

Note

Most endpoints use Authorization: Bearer <YOUR-TOKEN> and Accept: application/vnd.github+json headers, plus X-GitHub-Api-Version: 2026-03-10. Curl examples below omit these standard headers for brevity.

Get all requested reviewers for a pull request

GET /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers

Gets the users or teams whose review is requested for a pull request. Once a requested reviewer submits a review, they are no longer considered a requested reviewer. Their review will instead be returned by the List reviews for a pull request operation.

Parameters

Headers

accept (string)
Setting to application/vnd.github+json is recommended.

Path and query parameters

owner (string) (required)
The account owner of the repository. The name is not case sensitive.
repo (string) (required)
The name of the repository without the .git extension. The name is not case sensitive.
pull_number (integer) (required)
The number that identifies the pull request.

HTTP response status codes

200 - OK

Code examples

Example

Request:

curl -L \
  -X GET \
  https://api.github.com/repos/OWNER/REPO/pulls/PULL_NUMBER/requested_reviewers

Response schema (Status: 200):

users: required, array of Simple User:
- name: string or null
- email: string or null
- login: required, string
- id: required, integer, format: int64
- node_id: required, string
- avatar_url: required, string, format: uri
- gravatar_id: required, string or null
- url: required, string, format: uri
- html_url: required, string, format: uri
- followers_url: required, string, format: uri
- following_url: required, string
- gists_url: required, string
- starred_url: required, string
- subscriptions_url: required, string, format: uri
- organizations_url: required, string, format: uri
- repos_url: required, string, format: uri
- events_url: required, string
- received_events_url: required, string, format: uri
- type: required, string
- site_admin: required, boolean
- starred_at: string
- user_view_type: string
teams: required, array of Team:
- id: required, integer
- node_id: required, string
- name: required, string
- slug: required, string
- description: required, string or null
- privacy: string
- notification_setting: string
- permission: required, string
- permissions: object:
  - pull: required, boolean
  - triage: required, boolean
  - push: required, boolean
  - maintain: required, boolean
  - admin: required, boolean
- url: required, string, format: uri
- html_url: required, string, format: uri
- members_url: required, string
- repositories_url: required, string, format: uri
- type: required, string, enum: enterprise, organization
- access_source: string, enum: direct, organization, enterprise
- organization_id: integer
- enterprise_id: integer
- parent: required, any of:
  - null
  - Team Simple
    - id: required, integer
    - node_id: required, string
    - url: required, string, format: uri
    - members_url: required, string
    - name: required, string
    - description: required, string or null
    - permission: required, string
    - privacy: string
    - notification_setting: string
    - html_url: required, string, format: uri
    - repositories_url: required, string, format: uri
    - slug: required, string
    - ldap_dn: string
    - type: required, string, enum: enterprise, organization
    - organization_id: integer
    - enterprise_id: integer

Request reviewers for a pull request

POST /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers

Requests reviews for a pull request from a given set of users and/or teams.
This endpoint triggers notifications. Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "Rate limits for the API" and "Best practices for using the REST API."

Parameters

Headers

accept (string)
Setting to application/vnd.github+json is recommended.

Path and query parameters

owner (string) (required)
The account owner of the repository. The name is not case sensitive.
repo (string) (required)
The name of the repository without the .git extension. The name is not case sensitive.
pull_number (integer) (required)
The number that identifies the pull request.

Body parameters

reviewers (array of strings)
An array of user logins that will be requested.
team_reviewers (array of strings)
An array of team slugs that will be requested.

HTTP response status codes

201 - Created
403 - Forbidden
422 - Unprocessable Entity if user is not a collaborator
503 - Service unavailable

Code examples

Example

Request:

curl -L \
  -X POST \
  https://api.github.com/repos/OWNER/REPO/pulls/PULL_NUMBER/requested_reviewers \
  -d '{
  "reviewers": [
    "octocat",
    "hubot",
    "other_user"
  ],
  "team_reviewers": [
    "justice-league"
  ]
}'

Response schema (Status: 201):

url: required, string, format: uri
id: required, integer, format: int64
node_id: required, string
html_url: required, string, format: uri
diff_url: required, string, format: uri
patch_url: required, string, format: uri
issue_url: required, string, format: uri
commits_url: required, string, format: uri
review_comments_url: required, string, format: uri
review_comment_url: required, string
comments_url: required, string, format: uri
statuses_url: required, string, format: uri
number: required, integer
state: required, string
locked: required, boolean
title: required, string
user: required, any of:
- null
- Simple User
  - name: string or null
  - email: string or null
  - login: required, string
  - id: required, integer, format: int64
  - node_id: required, string
  - avatar_url: required, string, format: uri
  - gravatar_id: required, string or null
  - url: required, string, format: uri
  - html_url: required, string, format: uri
  - followers_url: required, string, format: uri
  - following_url: required, string
  - gists_url: required, string
  - starred_url: required, string
  - subscriptions_url: required, string, format: uri
  - organizations_url: required, string, format: uri
  - repos_url: required, string, format: uri
  - events_url: required, string
  - received_events_url: required, string, format: uri
  - type: required, string
  - site_admin: required, boolean
  - starred_at: string
  - user_view_type: string
body: required, string or null
labels: required, array of objects:
- id: required, integer, format: int64
- node_id: required, string
- url: required, string
- name: required, string
- description: required, string
- color: required, string
- default: required, boolean
- archived_by: required, all of:
  - Simple User (see above)
milestone: required, any of:
- null
- Milestone
  - url: required, string, format: uri
  - html_url: required, string, format: uri
  - labels_url: required, string, format: uri
  - id: required, integer
  - node_id: required, string
  - number: required, integer
  - state: required, string, enum: open, closed, default: "open"
  - title: required, string
  - description: required, string or null
  - creator: required, any of:
    - null
    - Simple User (see above)
  - open_issues: required, integer
  - closed_issues: required, integer
  - created_at: required, string, format: date-time
  - updated_at: required, string, format: date-time
  - closed_at: required, string or null, format: date-time
  - due_on: required, string or null, format: date-time
active_lock_reason: string or null
created_at: required, string, format: date-time
updated_at: required, string, format: date-time
closed_at: required, string or null, format: date-time
merged_at: required, string or null, format: date-time
assignees: array of Simple User (see above)
requested_reviewers: array of Simple User (see above)
requested_teams: array of Team:
- id: required, integer
- node_id: required, string
- name: required, string
- slug: required, string
- description: required, string or null
- privacy: string
- notification_setting: string
- permission: required, string
- permissions: object:
  - pull: required, boolean
  - triage: required, boolean
  - push: required, boolean
  - maintain: required, boolean
  - admin: required, boolean
- url: required, string, format: uri
- html_url: required, string, format: uri
- members_url: required, string
- repositories_url: required, string, format: uri
- type: required, string, enum: enterprise, organization
- access_source: string, enum: direct, organization, enterprise
- organization_id: integer
- enterprise_id: integer
- parent: required, any of:
  - null
  - Team Simple
    - id: required, integer
    - node_id: required, string
    - url: required, string, format: uri
    - members_url: required, string
    - name: required, string
    - description: required, string or null
    - permission: required, string
    - privacy: string
    - notification_setting: string
    - html_url: required, string, format: uri
    - repositories_url: required, string, format: uri
    - slug: required, string
    - ldap_dn: string
    - type: required, string, enum: enterprise, organization
    - organization_id: integer
    - enterprise_id: integer
head: required, object:
- label: required, string
- ref: required, string
- repo: required, Repository:
  - id: required, integer, format: int64
  - node_id: required, string
  - name: required, string
  - full_name: required, string
  - license: required, any of:
    - null
    - License Simple
      - key: required, string
      - name: required, string
      - url: required, string or null, format: uri
      - spdx_id: required, string or null
      - node_id: required, string
      - html_url: string, format: uri
  - forks: required, integer
  - permissions: object:
    - admin: required, boolean
    - pull: required, boolean
    - triage: boolean
    - push: required, boolean
    - maintain: boolean
  - owner: required, Simple User (see above)
  - private: required, boolean, default: false
  - html_url: required, string, format: uri
  - description: required, string or null
  - fork: required, boolean
  - url: required, string, format: uri
  - archive_url: required, string
  - assignees_url: required, string
  - blobs_url: required, string
  - branches_url: required, string
  - collaborators_url: required, string
  - comments_url: required, string
  - commits_url: required, string
  - compare_url: required, string
  - contents_url: required, string
  - contributors_url: required, string, format: uri
  - deployments_url: required, string, format: uri
  - downloads_url: required, string, format: uri
  - events_url: required, string, format: uri
  - forks_url: required, string, format: uri
  - git_commits_url: required, string
  - git_refs_url: required, string
  - git_tags_url: required, string
  - git_url: required, string
  - issue_comment_url: required, string
  - issue_events_url: required, string
  - issues_url: required, string
  - keys_url: required, string
  - labels_url: required, string
  - languages_url: required, string, format: uri
  - merges_url: required, string, format: uri
  - milestones_url: required, string
  - notifications_url: required, string
  - pulls_url: required, string
  - releases_url: required, string
  - ssh_url: required, string
  - stargazers_url: required, string, format: uri
  - statuses_url: required, string
  - subscribers_url: required, string, format: uri
  - subscription_url: required, string, format: uri
  - tags_url: required, string, format: uri
  - teams_url: required, string, format: uri
  - trees_url: required, string
  - clone_url: required, string
  - mirror_url: required, string or null, format: uri
  - hooks_url: required, string, format: uri
  - svn_url: required, string, format: uri
  - homepage: required, string or null, format: uri
  - language: required, string or null
  - forks_count: required, integer
  - stargazers_count: required, integer
  - watchers_count: required, integer
  - size: required, integer
  - default_branch: required, string
  - open_issues_count: required, integer
  - is_template: boolean, default: false
  - topics: array of string
  - has_issues: required, boolean, default: true
  - has_projects: required, boolean, default: true
  - has_wiki: required, boolean, default: true
  - has_pages: required, boolean
  - has_discussions: boolean, default: false
  - has_pull_requests: boolean, default: true
  - pull_request_creation_policy: string, enum: all, collaborators_only
  - archived: required, boolean, default: false
  - disabled: required, boolean
  - visibility: string, default: "public"
  - pushed_at: required, string or null, format: date-time
  - created_at: required, string or null, format: date-time
  - updated_at: required, string or null, format: date-time
  - allow_rebase_merge: boolean, default: true
  - temp_clone_token: string
  - allow_squash_merge: boolean, default: true
  - allow_auto_merge: boolean, default: false
  - delete_branch_on_merge: boolean, default: false
  - allow_update_branch: boolean, default: false
  - squash_merge_commit_title: string, enum: PR_TITLE, COMMIT_OR_PR_TITLE
  - squash_merge_commit_message: string, enum: PR_BODY, COMMIT_MESSAGES, BLANK
  - merge_commit_title: string, enum: PR_TITLE, MERGE_MESSAGE
  - merge_commit_message: string, enum: PR_BODY, PR_TITLE, BLANK
  - allow_merge_commit: boolean, default: true
  - allow_forking: boolean
  - web_commit_signoff_required: boolean, default: false
  - open_issues: required, integer
  - watchers: required, integer
  - starred_at: string
  - anonymous_access_enabled: boolean
  - code_search_index_status: object:
    - lexical_search_ok: boolean
    - lexical_commit_sha: string
- sha: required, string
- user: required, any of:
  - null
  - Simple User (see above)
base: required, object:
- label: required, string
- ref: required, string
- repo: required, Repository (see above)
- sha: required, string
- user: required, any of:
  - null
  - Simple User (see above)
_links: required, object:
- comments: required, Link:
  - href: required, string
- commits: required, Link (see above)
- statuses: required, Link (see above)
- html: required, Link (see above)
- issue: required, Link (see above)
- review_comments: required, Link (see above)
- review_comment: required, Link (see above)
- self: required, Link (see above)
author_association: required, string, enum: COLLABORATOR, CONTRIBUTOR, FIRST_TIMER, FIRST_TIME_CONTRIBUTOR, MANNEQUIN, MEMBER, NONE, OWNER
auto_merge: required, Auto merge:
- enabled_by: required, Simple User (see above)
- merge_method: required, string, enum: merge, squash, rebase
- commit_title: required, string
- commit_message: required, string
stack: Pull Request Stack:
- base: required, object:
  - ref: required, string
  - sha: required, string
- size: integer
- position: integer
- id: integer
- number: integer
draft: boolean

Remove requested reviewers from a pull request

DELETE /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers

Removes review requests from a pull request for a given set of users and/or teams.

Parameters

Headers

accept (string)
Setting to application/vnd.github+json is recommended.

Path and query parameters

owner (string) (required)
The account owner of the repository. The name is not case sensitive.
repo (string) (required)
The name of the repository without the .git extension. The name is not case sensitive.
pull_number (integer) (required)
The number that identifies the pull request.

Body parameters

reviewers (array of strings) (required)
An array of user logins that will be removed.
team_reviewers (array of strings)
An array of team slugs that will be removed.

HTTP response status codes

200 - OK
422 - Validation failed, or the endpoint has been spammed.

Code examples

Example

Request:

curl -L \
  -X DELETE \
  https://api.github.com/repos/OWNER/REPO/pulls/PULL_NUMBER/requested_reviewers \
  -d '{
  "reviewers": [
    "octocat",
    "hubot",
    "other_user"
  ],
  "team_reviewers": [
    "justice-league"
  ]
}'

Response schema (Status: 200):

Same response schema as Request reviewers for a pull request.

Rerequest reviewers for a pull request

POST /repos/{owner}/{repo}/pulls/{pull_number}/requested_reviewers/rerequest

Rerequests reviews for a pull request from a given set of users and/or teams.
This endpoint triggers notifications. Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "Rate limits for the API" and "Best practices for using the REST API."

Parameters

Headers

accept (string)
Setting to application/vnd.github+json is recommended.

Path and query parameters

owner (string) (required)
The account owner of the repository. The name is not case sensitive.
repo (string) (required)
The name of the repository without the .git extension. The name is not case sensitive.
pull_number (integer) (required)
The number that identifies the pull request.

Body parameters

reviewers (array of strings)
An array of user logins whose reviews will be rerequested.
team_reviewers (array of strings)
An array of team slugs whose reviews will be rerequested.

HTTP response status codes

201 - Created
403 - Forbidden
422 - Unprocessable Entity if user is not a collaborator

Code examples

Example

Request:

curl -L \
  -X POST \
  https://api.github.com/repos/OWNER/REPO/pulls/PULL_NUMBER/requested_reviewers/rerequest \
  -d '{
  "reviewers": [
    "octocat",
    "hubot",
    "other_user"
  ],
  "team_reviewers": [
    "justice-league"
  ]
}'

Response schema (Status: 201):

Same response schema as Request reviewers for a pull request.