> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get comments on entity

> MCP tool to retrieve threaded comment conversations in the Thena platform.

# Get Comments on Entity

Retrieve all comments for a specific entity in the Thena platform.

## Parameters

| Name       | Type   | Required | Description                                             |
| ---------- | ------ | -------- | ------------------------------------------------------- |
| entityType | string | Yes      | The type of the entity (e.g., "ticket", "conversation") |
| entityId   | string | Yes      | The ID of the entity to get comments for                |
| page       | number | No       | The page number for pagination (default: 0)             |
| limit      | number | No       | Maximum number of comments to return (default: 10)      |

### Example prompt

```prompt theme={null}
Get all comments for ticket NYD3S01K100PGBTVWPMTPX8W4W3G6
```

### Response fields

Each item in the `data` array is a comment object with the following fields:

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr><td>id</td><td>string</td><td>Comment unique ID</td></tr>
    <tr><td>content</td><td>string</td><td>Plain text content of the comment</td></tr>
    <tr><td>contentHtml</td><td>string</td><td>HTML formatted content</td></tr>
    <tr><td>contentMarkdown</td><td>string</td><td>Markdown formatted content</td></tr>
    <tr><td>contentJson</td><td>string</td><td>JSON formatted content for rich text</td></tr>
    <tr><td>isEdited</td><td>boolean</td><td>Whether the comment has been edited</td></tr>
    <tr><td>threadName</td><td>string</td><td>Name of the comment thread</td></tr>
    <tr><td>commentVisibility</td><td>string</td><td>Visibility setting (public or private)</td></tr>
    <tr><td>commentType</td><td>string</td><td>Type of comment (note, reply, comment, etc.)</td></tr>
    <tr><td>isPinned</td><td>boolean</td><td>Whether the comment is pinned</td></tr>
    <tr><td>sourceEmailId</td><td>string</td><td>Email ID if comment came from email</td></tr>
    <tr><td>metadata</td><td>object</td><td>Additional metadata including mentions, userReactions, and sometimes replies</td></tr>
    <tr><td>createdAt</td><td>string (ISO8601)</td><td>Creation timestamp</td></tr>
    <tr><td>updatedAt</td><td>string (ISO8601)</td><td>Last update timestamp</td></tr>
    <tr><td>author</td><td>string</td><td>Author display name</td></tr>
    <tr><td>authorAvatarUrl</td><td>string</td><td>Author's avatar URL</td></tr>
    <tr><td>attachments</td><td>array</td><td>Array of attachment IDs</td></tr>
    <tr><td>authorId</td><td>string</td><td>Author's user ID</td></tr>
    <tr><td>authorUserType</td><td>string</td><td>Author's user type (e.g., ORG\_ADMIN)</td></tr>
    <tr><td>impersonatedUserEmail</td><td>string</td><td>Email of impersonated user</td></tr>
    <tr><td>impersonatedUserName</td><td>string</td><td>Name of impersonated user</td></tr>
    <tr><td>impersonatedUserAvatar</td><td>string</td><td>Avatar of impersonated user</td></tr>
    <tr><td>deletedAt</td><td>string</td><td>Deletion timestamp (null if not deleted)</td></tr>
  </tbody>
</table>

### Sample response

```json theme={null}
{
  "data": [
    {
      "id": "G727S01K1045B01QRQY2P1ATK3R5F",
      "content": "Internal note: This performance issue might be related to the recent deployment we did last Tuesday (v2.4.3). Sarah mentioned in the standup that they noticed some unusual query patterns after that release. \n\nNeed to check:\n- Did we accidentally remove any indexes during the schema migration?\n- The new caching layer might not be working as expected\n- Could be related to the user session timeout changes\n\nAlso, Alex (the requestor) is from our biggest client - BusinessCorp. They're up for renewal next month, so this needs to be prioritized. Marketing has been pushing hard to keep them happy.\n\nI'll coordinate with the DevOps team offline about the maintenance window. Don't want to mention specific timing in public comments until we confirm availability.",
      "contentHtml": "",
      "contentMarkdown": "...",
      "contentJson": "...",
      "isEdited": false,
      "threadName": null,
      "commentVisibility": "private",
      "commentType": "note",
      "isPinned": false,
      "sourceEmailId": null,
      "metadata": {
        "mentions": [],
        "userReactions": []
      },
      "createdAt": "2025-07-25T12:34:04.651Z",
      "updatedAt": "2025-07-25T12:34:04.650Z",
      "author": "shakthi+1",
      "authorAvatarUrl": null,
      "attachments": [],
      "authorId": "UTH00SEXXFNVVN",
      "authorUserType": "ORG_ADMIN",
      "impersonatedUserEmail": null,
      "impersonatedUserName": null,
      "impersonatedUserAvatar": null,
      "deletedAt": null
    }
  ],
  "status": true,
  "message": "Comments fetched successfully!",
  "timestamp": "2025-07-25T12:48:11.462Z"
}
```