Update the content of a change request comment reply

Replaces the body of an existing reply in a change request comment thread. Use this to correct or amend a reply you previously posted. Only the reply author or space admins can update a reply.

Available in MCP

put

Authorizations

useroauth

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_-]+$

commentIdstringRequired

A unique entity identifier

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

commentReplyIdstringRequired

A unique entity identifier

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

Body

application/json

resolvedbooleanOptional

Whether the comment is resolved or not.

bodyone ofOptional

Content of the comment.

or

or

object · EmptyOptional

addedReactionsstring[]Optional

Reactions to add to the comment.

removedReactionsstring[]Optional

Reactions to remove from the comment.

Responses

200

The reply was updated.

application/json

objectstring · enumRequired

Type of Object, always equals to "comment-reply"

Possible values:

idstringRequired

Unique identifier for the reply.

postedAtstring · date-timeRequired

editedAtstring · date-timeOptional

Date when the reply was edited, if it has been edited.

bodyone ofRequired

or

or

object · EmptyOptional

put/spaces/{spaceId}/change-requests/{changeRequestId}/comments/{commentId}/replies/{commentReplyId}

HTTPcURLJavaScriptPython

PUT /v1/spaces/{spaceId}/change-requests/{changeRequestId}/comments/{commentId}/replies/{commentReplyId} HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 183

{
  "resolved": true,
  "body": {
    "markdown": "# Hello World\n\nThis is a markdown document linking to [another page](/pages/page_id).\n"
  },
  "addedReactions": [
    "text"
  ],
  "removedReactions": [
    "text"
  ]
}

200

The reply was updated.

{
  "object": "comment-reply",
  "id": "text",
  "postedBy": {
    "object": "user",
    "id": "text",
    "displayName": "text",
    "email": "text",
    "photoURL": "text",
    "urls": {
      "location": "https://example.com"
    }
  },
  "postedAt": "2026-07-21T21:50:11.272Z",
  "editedAt": "2026-07-21T21:50:11.272Z",
  "reactions": [
    {
      "emoji": "text",
      "count": 1,
      "users": [
        {
          "user": {
            "object": "user",
            "id": "text",
            "displayName": "text",
            "email": "text",
            "photoURL": "text",
            "urls": {
              "location": "https://example.com"
            }
          },
          "reactedAt": "2026-07-21T21:50:11.272Z"
        }
      ]
    }
  ],
  "body": {
    "markdown": "# Hello World\n\nThis is a markdown document linking to [another page](/pages/page_id).\n"
  },
  "urls": {
    "location": "https://example.com"
  },
  "permissions": {
    "view": true,
    "edit": true,
    "reply": true,
    "delete": true
  }
}