Comments
Update comment
Updates a comment by its comment_id.
PATCH
TypeScript SDK
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.
rich_text or markdown must be provided. Providing both or neither will return a validation error.
With markdown, set markdown_version: "v2" to write Notion-flavored Markdown instead of enhanced markdown. v2 is recommended. v1 is deprecated. It’s the default on current Notion-Versions. Sending markdown_version with rich_text returns a 400 validation_error. See Markdown versions.
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
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11 Body
application/json
- Option 1
- Option 2
The Markdown syntax to use. v2 is Notion-flavored Markdown and is recommended. v1 is enhanced markdown. It's deprecated. It's the default on current Notion-Versions. The next Notion-Version rejects v1 with a 400 validation_error.
Available options:
v1, v2