API / update-origin-pull-request-review-via-api

API

Update an Origin Pull Request Review via the API

Update the body of a review with PATCH https://api.cursor.com/v1/origin/repos/{ownerSlug}/{repoName}/pulls/{pullNumber}/reviews/{reviewId}. Official reference: Origin API → Update Pull Request Review (OpenAPI OriginService_UpdatePullRequestReview).

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:write. Availability: Early Beta per the API overview.

Only the review author can update it; other callers receive PERMISSION_DENIED (HTTP 403). A review that does not belong to the named pull request returns NOT_FOUND (HTTP 404). Unsubmitted draft reviews can be updated too; a draft's response has no submittedAt. The new body replaces the prior body in full and must contain a non-whitespace character (INVALID_ARGUMENT otherwise). Pull request number is a JSON string. An unknown or unreachable pull returns 404. A 404 never distinguishes a missing pull from one your installation cannot reach.

Cost: 5 points against the principal budget (ordinary write).

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)
reviewId yes Stable review identifier (rev_…)

Request body

Field Required Meaning
body yes Replacement review summary text; must contain a non-whitespace character
curl --request PATCH \
  --url 'https://api.cursor.com/v1/origin/repos/OWNER_SLUG/REPO_NAME/pulls/17/reviews/rev_01k2ja2000e0080000000000f6' \
  --header 'Authorization: Bearer YOUR_ORIGIN_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "body": "Approving. The telemetry schema matches the spec."
}'

Response

200 returns the updated review: id, author, verdict, body, optional submittedAt, pullRequestVersion, and optional dismissal.

{
  "id": "rev_01k2ja2000e0080000000000f6",
  "author": {
    "user": {
      "id": "user_01k2ja2000e0080000000000c3",
      "email": "jane@acme.dev"
    }
  },
  "verdict": "approve",
  "body": "Approving. The telemetry schema matches the spec.",
  "submittedAt": "2026-08-02T15:00:00Z",
  "pullRequestVersion": {
    "number": "3",
    "headSha": "9a41f0c3d2b8e7f6a5c4d3e2f1b0a9c8d7e6f5a4",
    "baseSha": "3b1f9c2d8a7e6f5049c8b7a6d5e4f3a2b1c0d9e8",
    "createdAt": "2026-08-01T09:30:00Z"
  }
}

List reviews with List Pull Request Reviews. Base URL: https://api.cursor.com/v1/origin.