Update a comment

Replaces the body of an existing comment. Only the comment’s author may edit it. Returns the updated comment.

Authorization

apiKey

Authorization<token>

API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.

In: header

Path Parameters

workspace*string

The workspace slug — the {slug} segment of your Clarify workspace URL.

id*string

The unique ID of the comment.

Query Parameters

silent?boolean

When true, suppresses in-app and Slack notifications for this mutation.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

message*array<>

The comment body, as an array of rich-text (BlockNote) nodes.

Response Body

`application/json`

curl -X PATCH "https://example.com/workspaces/string/comments/string" \  -H "Content-Type: application/json" \  -d '{    "message": [      {        "id": "1",        "type": "paragraph",        "children": [],        "content": [          {            "type": "text",            "text": "Followed up after the QBR — Jane signed off on pricing.",            "styles": {}          }        ]      }    ]  }'

{
  "_id": "9d3e1f7a-2c4b-4e6d-8a1f-5b7c9e0d2a46",
  "message": [
    {
      "id": "1",
      "type": "paragraph",
      "children": [],
      "content": [
        {
          "type": "text",
          "text": "Followed up after the QBR — Jane wants pricing by Friday.",
          "styles": {}
        }
      ]
    }
  ],
  "owner_id": "5f8b7d2e-9c4a-4e1b-8f3d-2a6c9e0b4d71",
  "entity": "person",
  "_created_at": "2026-01-15T09:30:00.000Z",
  "_created_by": "7d4e2f9a-1b3c-4d5e-8f6a-9c0b2d4e6f81",
  "_updated_at": null,
  "_updated_by": null
}