
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.