Update the body of a reply to a space comment

Updates the content of an existing reply to a comment in a space. Only the reply author or a space admin can update the reply. To update the parent comment, use the space comment update endpoint.

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

commentIdstringRequired

A unique entity identifier

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

commentReplyIdstringRequired

A unique entity identifier

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

Body

application/json

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}/comments/{commentId}/replies/{commentReplyId}

HTTPcURLJavaScriptPython

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

{
  "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-21T23:01:58.684Z",
  "editedAt": "2026-07-21T23:01:58.684Z",
  "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-21T23:01:58.684Z"
        }
      ]
    }
  ],
  "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
  }
}