> ## 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 comment threads

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

import Admonition from '@theme/Admonition';

### MCP tool: `get_comment_threads`

Retrieves threaded comment conversations for a parent comment. Useful for viewing organized discussions and reply chains.

<Admonition type="note">
  You must provide the parent comment ID to retrieve its thread of replies.
</Admonition>

### Example prompt

```prompt theme={null}
Get comment threads for comment S5Q6R01K1052NAMN8YGYHYGKZG082
```

<Admonition type="info">
  When you use this prompt in a chat with the model (with the MCP tool registered), the model will automatically call the <code>get\_comment\_threads</code> tool with the correct arguments.
</Admonition>

### Input parameters

| Name      | Type   | Required | Description                                               |
| --------- | ------ | -------- | --------------------------------------------------------- |
| commentId | string | Yes      | The ID of the parent comment to get threads for           |
| page      | number | No       | The page number for pagination (default: 0)               |
| limit     | number | No       | Maximum number of thread comments to return (default: 10) |

### Response fields

Below are the fields you may see in each comment thread object in the response:

<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 and userReactions</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": "X66KS01K10E5FVTJK7ZVRW3AKVYDD",
      "content": "this is a reply",
      "contentHtml": "<p>this is a reply</p>",
      "contentMarkdown": "this is a reply",
      "contentJson": "\"{\\"type\\":\\"doc\\",\\"content\\":[{\\"type\\":\\"paragraph\\",\\"attrs\\":{\\"textAlign\\":\\"left\\"},\\"content\\":[{\\"type\\":\\"text\\",\\"text\\":\\"this is a reply\\"}]}]}\"",
      "isEdited": false,
      "threadName": null,
      "commentVisibility": "public",
      "commentType": "comment",
      "isPinned": false,
      "sourceEmailId": null,
      "metadata": {
        "mentions": [],
        "userReactions": []
      },
      "createdAt": "2025-07-25T12:40:41.944Z",
      "updatedAt": "2025-07-25T12:40:41.941Z",
      "author": "shakthi+1",
      "authorAvatarUrl": null,
      "attachments": [],
      "authorId": "UTH00SEXXFNVVN",
      "authorUserType": "ORG_ADMIN",
      "impersonatedUserEmail": null,
      "impersonatedUserName": null,
      "impersonatedUserAvatar": null,
      "deletedAt": null
    }
  ],
  "status": true,
  "message": "Comment threads fetched successfully!",
  "timestamp": "2025-07-25T12:43:27.398Z"
}
```

<Admonition type="tip">
  Always pass an object as input, even if empty, to avoid errors when calling the tool directly.
</Admonition>

***
