Get a specific review on a change request by its ID

Retrieves the full details of a single review submission on a change request, including the decision status (approved/changes-requested), reviewer, and any attached comment. Use this when you have a review ID and need its full details.

Available in MCP
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
spaceIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$
changeRequestIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$
reviewIdstringRequired

The unique ID of the change request review.

Query parameters
formatstring · enumOptional

Output format for the content.

Possible values:
Responses
200

The matching change request review.

application/json
objectstring · enumRequired

Type of Object, always equals to "change-request-review"

Possible values:
idstringRequired

Unique identifier for the review.

revisionstringRequired

The revision this review was made against.

statusstring · enumRequired

The status of the review.

Possible values:
outdatedbooleanRequired

Whether this review has been superseded by a newer review request or submission.

createdAtstring · date-timeRequired
updatedAtstring · date-timeRequired
get/spaces/{spaceId}/change-requests/{changeRequestId}/reviews/{reviewId}
GET /v1/spaces/{spaceId}/change-requests/{changeRequestId}/reviews/{reviewId} HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "object": "change-request-review",
  "id": "text",
  "revision": "text",
  "reviewer": {
    "object": "user",
    "id": "text",
    "displayName": "text",
    "email": "text",
    "photoURL": "text",
    "urls": {
      "location": "https://example.com"
    }
  },
  "requestedBy": {
    "object": "user",
    "id": "text",
    "displayName": "text",
    "email": "text",
    "photoURL": "text",
    "urls": {
      "location": "https://example.com"
    }
  },
  "status": "changes-requested",
  "outdated": true,
  "comment": {
    "object": "comment",
    "id": "text",
    "postedBy": {
      "object": "user",
      "id": "text",
      "displayName": "text",
      "email": "text",
      "photoURL": "text",
      "urls": {
        "location": "https://example.com"
      }
    },
    "postedAt": "2026-01-01T00:00:00.000Z",
    "editedAt": "2026-01-01T00:00:00.000Z",
    "reactions": [
      {
        "emoji": "text",
        "count": 1,
        "users": [
          {
            "user": {
              "object": "user",
              "id": "text",
              "displayName": "text",
              "email": "text",
              "photoURL": "text",
              "urls": {
                "location": "https://example.com"
              }
            },
            "reactedAt": "2026-01-01T00:00:00.000Z"
          }
        ]
      }
    ],
    "replies": 1,
    "repliers": [
      {
        "updatedAt": "2026-01-01T00:00:00.000Z",
        "count": 1,
        "user": {
          "object": "user",
          "id": "text",
          "displayName": "text",
          "email": "text",
          "photoURL": "text",
          "urls": {
            "location": "https://example.com"
          }
        }
      }
    ],
    "body": {
      "markdown": "# Hello World\n\nThis is a markdown document linking to [another page](/pages/page_id).\n"
    },
    "target": {
      "node": {
        "id": "text"
      },
      "tableCell": {
        "record": "text",
        "definition": "text"
      },
      "changeRequest": "text",
      "review": "text",
      "page": {
        "id": "text"
      },
      "space": "text",
      "revision": "text"
    },
    "urls": {
      "location": "https://example.com"
    },
    "permissions": {
      "view": true,
      "edit": true,
      "reply": true,
      "delete": true
    },
    "status": "resolved",
    "resolvedAt": "2026-01-01T00:00:00.000Z",
    "resolvedBy": {
      "object": "user",
      "id": "text",
      "displayName": "text",
      "email": "text",
      "photoURL": "text",
      "urls": {
        "location": "https://example.com"
      }
    }
  },
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "urls": {
    "location": "https://example.com"
  }
}

Last updated

Was this helpful?

Powered by GitBook