Skip to main content
PATCH
/
v1
/
comments
/
{comment_id}
TypeScript SDK
import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.comments.update({
  comment_id: "c02fc1d3-db8b-45c5-a222-27595b15aea7",
  rich_text: [{ text: { content: "Updated comment text" } }]
})
{
  "object": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
Returns a comment object for the updated comment. An integration can only update comments that it created. Attempting to update a comment created by another user or integration will return a 404 error.

​
Comment body format

The comment body can be provided in one of two formats:
  • rich_text: An array of rich text objects that represent the updated content of the comment.
  • markdown: A Markdown string. Supports inline formatting (bold, italic, strikethrough, inline code, links), inline equations, and mentions.
Exactly one of rich_text or markdown must be provided. Providing both or neither will return a validation error.

​
Errors

Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.
Reminder: Turn on integration comment capabilitiesIntegration capabilities for reading and inserting comments are off by default.This endpoint requires an integration to have insert comment capabilities. Attempting to call this endpoint without insert comment capabilities will return an HTTP response with a 403 status code.For more information on integration capabilities, see the capabilities guide. To update your integration settings, visit the integration dashboard.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Path Parameters

​
comment_id
string
required

The ID of the comment to update.

Body

application/json
​
rich_text
(Text · object | Mention · object | Equation · object)[]
required

An array of rich text objects that represent the updated content of the comment.

Maximum array length: 100

Response

​
object
string
required

The comment object type name.

Allowed value: "comment"
​
id
string<uuid>
required

The ID of the comment.