Clarify API
Comments

Get a comment

Returns a single comment by its ID.

GET
/workspaces/{workspace}/comments/{id}

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.

Response Body

application/json

curl -X GET "https://example.com/workspaces/string/comments/string"
{
  "_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
}

Delete a comment

Permanently deletes a comment. A comment can be deleted by its author, by an admin, or by the owner of the agent that posted it. Returns the deleted comment. This cannot be undone.

Update a comment

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