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"
}

Documentation Index

Fetch the complete documentation index at: https://developers.notion.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns a comment object for the updated comment. A connection can only update comments that it created. Attempting to update a comment created by another user or connection 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 connection comment capabilitiesConnection capabilities for reading and inserting comments are off by default.This endpoint requires a connection 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 connection capabilities, see the capabilities guide. To update your connection settings, visit the Developer portal.

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.