Skip to main content
PATCH
/
repos
/
{repo_id}
/
reviews
/
{review_id}
Update review
curl --request PATCH \
  --url https://api.diversion.dev/v0/repos/{repo_id}/reviews/{review_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "open",
  "title": "<string>",
  "description": "<string>",
  "reviewer_ids": [
    "<string>"
  ]
}
'
{
  "id": "<string>",
  "title": "<string>",
  "status": "open",
  "author": {
    "id": "<string>",
    "image": "<string>",
    "email": "[email protected]",
    "full_name": "<string>",
    "name": "<string>",
    "tier": "EDUCATION"
  },
  "created_at": 123,
  "updated_at": 123,
  "base_ref": "<string>",
  "compare_ref": "<string>",
  "repo_id": "<string>",
  "description": "<string>",
  "reviewers": [
    {
      "id": "<string>",
      "image": "<string>",
      "email": "[email protected]",
      "full_name": "<string>",
      "name": "<string>",
      "tier": "EDUCATION"
    }
  ],
  "reviewer_statuses": [
    {
      "user_id": "<string>",
      "status": "requested",
      "updated_at": 123
    }
  ],
  "merge_commit_id": 123,
  "active_merge_id": "<string>",
  "draft_commit_id": "<string>"
}

Authorizations

Authorization
string
header
required

This API uses OAuth 2 with the implicit grant flow

Path Parameters

repo_id
string
required

The repo ID of the repository. Repo name can be used instead of the ID, but usage of ID for permanent linking and API requests is preferred.

Required string length: 3 - 128
Example:

"example_id"

review_id
string
required

Review ID

Maximum string length: 128

Body

application/json

Payload for updating a review

status
enum<string>

New review status

Available options:
open,
closed
title
string

New review title

Maximum string length: 1024
description
string

New review description

Maximum string length: 4096
reviewer_ids
string[]

Updated list of reviewer user IDs

Maximum string length: 256

Response

Review updated successfully

Review details

id
string
required

Review ID

title
string
required

Review title

status
enum<string>
required

Review status

Available options:
open,
closed
author
object
required

User details

created_at
integer
required

Unix timestamp when the review was created

updated_at
integer
required

Unix timestamp when the review was last updated

base_ref
string
required

Base reference (branch/commit)

compare_ref
string
required

Compare reference (branch/commit)

repo_id
string
required

Repository ID

description
string

Review description

reviewers
object[]

List of reviewers

reviewer_statuses
object[]

List of reviewer statuses

merge_commit_id
integer

ID of the commit that merged this review

active_merge_id
string

ID of active merge with conflicts

draft_commit_id
string

ID of the draft commit that created this review