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.
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
spaceIdstringRequiredPattern:
A unique entity identifier
^[a-zA-Z0-9_-]+$changeRequestIdstringRequiredPattern:
A unique entity identifier
^[a-zA-Z0-9_-]+$reviewIdstringRequired
The unique ID of the change request review.
Query parameters
formatstring · enumOptionalPossible values:
Output format for the content.
Responses
200
The matching change request review.
application/json
objectstring · enumRequiredPossible values:
Type of Object, always equals to "change-request-review"
idstringRequired
Unique identifier for the review.
revisionstringRequired
The revision this review was made against.
statusstring · enumRequiredPossible values:
The status of the review.
outdatedbooleanRequired
Whether this review has been superseded by a newer review request or submission.
createdAtstring · date-timeRequired
updatedAtstring · date-timeRequired
404
The change request review could not be found.
application/json
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?