API / list-origin-pull-request-requested-reviewers-via-api

API

List Origin Pull Request Requested Reviewers via the API

List the users and groups whose review is currently requested on a pull request with GET https://api.cursor.com/v1/origin/repos/{ownerSlug}/{repoName}/pulls/{pullNumber}/requested_reviewers. Official reference: Origin API → List Pull Request Requested Reviewers (OpenAPI OriginService_ListPullRequestRequestedReviewers).

Origin is in Early Beta and subject to change. Authenticate with an installation access token (oit_…) or a user access token that carries repository:pull_requests:reviews:read. Availability: Early Beta per the API overview.

A direct request clears when that user submits a review, and a group request clears when any current member of the group submits. Unsubmitted draft reviews leave the request pending. Requesting review again after a submission returns the reviewer to this list. Groups without a readable public identifier are omitted. There are no pagination parameters. Pull request number is a JSON string (protobuf 64-bit encoding). An unknown or unreachable pull returns 404. A 404 never distinguishes a missing pull from one your installation cannot reach.

Cost: 1 point against the principal budget (ordinary read).

Path parameters

Param Required Meaning
ownerSlug yes Owning entity's unique slug
repoName yes Repo name, unique to the owner
pullNumber yes Pull request number within the repository (string on the wire)
curl --request GET \
  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME/pulls/17/requested_reviewers' \
  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN'

Response

200 returns users and groups. Each user carries id (user_…), email (empty when none), optional displayName, and optional handle (no @; only while the profile is publicly visible). Each group carries id (grp_…). Either array is empty when none are pending.

{
  "users": [
    {
      "id": "user_01k2ja2000e0080000000000c3",
      "email": "jane@acme.dev"
    }
  ],
  "groups": [
    {
      "id": "grp_01k2ja2000e0080000000000n2"
    }
  ]
}

Request or clear reviewers with Request or Remove Pull Request Requested Reviewers. Base URL: https://api.cursor.com/v1/origin.