Comments

Update a comment

Changed on
patch/v1/comments/{comment_id}

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/comments/{comment_id}
  • Auth
    HTTP bearer

Path parameters

comment_idstring required

Headers

Notion-Version'2026-03-11' required

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

Request body

OR

Example request

{
  "rich_text": [
    {
      "text": {
        "link": {
          "url": "https://www.notion.com"
        }
      }
    }
  ]
}

Response

OR

Example response

{
  "rich_text": [
    {
      "text": {
        "link": {
          "url": "https://www.notion.com"
        }
      }
    }
  ]
}

Changes

  • ed50532d1d7eRevision changes
    • breaking

      added subschema #1 subschema #2 to the request body allOf list

    • breaking

      removed subschema #1 subschema #2 from the request body oneOf list

  • aee63faed685Revision changes
    • info

      added the required property //// to the response with the status