> ## 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.

# Create ticket comment

> MCP tool to add a comment to a ticket in the Thena platform.

import Admonition from '@theme/Admonition';

### MCP tool: `create_ticket_comment`

Adds a comment to a ticket in the Thena platform. Useful for collaboration, support, and ticket updates.

<Admonition type="note">
  The required fields are <code>id</code> (ticket ID) and <code>content</code> (comment text). All other fields are optional.
</Admonition>

### Example prompt

```prompt theme={null}
Add a comment "Thank you for reporting this database connection timeout issue. I've escalated this to our database team for investigation. Expected resolution timeframe: 24-48 hours." to ticket SY7BWX0K10YKRDE5FAHNBHFBS986H
```

<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>create\_ticket\_comment</code> tool with the correct arguments.
</Admonition>

### Input parameters

| Name                   | Type      | Required | Description                           |
| ---------------------- | --------- | -------- | ------------------------------------- |
| id                     | string    | Yes      | The ID of the ticket to comment on    |
| content                | string    | Yes      | The content of the comment            |
| contentHtml            | string    | No       | The HTML content of the comment       |
| contentJson            | string    | No       | The JSON content of the comment       |
| threadName             | string    | No       | The name of the comment thread        |
| parentCommentId        | string    | No       | The ID of the parent comment          |
| commentVisibility      | string    | No       | Comment visibility (e.g., "public")   |
| commentType            | string    | No       | Type of comment (e.g., "comment")     |
| customerEmail          | string    | No       | The email of the customer             |
| metadata               | object    | No       | Additional metadata                   |
| attachmentIds          | string\[] | No       | IDs of attachments                    |
| impersonatedUserEmail  | string    | No       | Email of impersonated user            |
| impersonatedUserName   | string    | No       | Name of impersonated user             |
| impersonatedUserAvatar | string    | No       | Avatar of impersonated user           |
| shouldSendEmail        | boolean   | No       | Whether to send an email notification |
| createdAt              | string    | No       | Creation timestamp (ISO8601)          |

### Response fields

Below are the fields you may see in the response:

| Field                  | Type    | Description                           |
| ---------------------- | ------- | ------------------------------------- |
| id                     | string  | Comment unique ID                     |
| content                | string  | Comment text                          |
| contentHtml            | string  | HTML content                          |
| contentMarkdown        | string  | Markdown content                      |
| contentJson            | string  | JSON content                          |
| isEdited               | boolean | Whether the comment was edited        |
| threadName             | string  | Thread name                           |
| commentVisibility      | string  | Comment visibility                    |
| commentType            | string  | Type of comment                       |
| isPinned               | boolean | Whether the comment is pinned         |
| sourceEmailId          | string  | Source email ID                       |
| metadata               | object  | Metadata (e.g., mentions)             |
| createdAt              | string  | Creation timestamp (ISO8601)          |
| updatedAt              | string  | Last update timestamp (ISO8601)       |
| author                 | string  | Author username or email              |
| authorAvatarUrl        | string  | Author avatar URL                     |
| attachments            | array   | List of attachment objects            |
| authorId               | string  | Author user ID                        |
| authorUserType         | string  | Author user type (e.g., "ORG\_ADMIN") |
| impersonatedUserEmail  | string  | Impersonated user email               |
| impersonatedUserName   | string  | Impersonated user name                |
| impersonatedUserAvatar | string  | Impersonated user avatar              |
| deletedAt              | string  | Deletion timestamp (if deleted)       |

Other top-level fields in the response:

| Field     | Type    | Description                               |
| --------- | ------- | ----------------------------------------- |
| data      | object  | The created comment object                |
| status    | boolean | Whether the creation succeeded            |
| message   | string  | Status message                            |
| timestamp | string  | Time the response was generated (ISO8601) |

***

### Sample response

```json theme={null}
{
  "data": {
    "id": "SY7BWX0K10YKRDE5FAHNBHFBS986H",
    "content": "Thank you for reporting this database connection timeout issue. I've escalated this to our database team for investigation. Expected resolution timeframe: 24-48 hours.",
    "contentHtml": "",
    "contentMarkdown": "Thank you for reporting this database connection timeout issue. I've escalated this to our database team for investigation. Expected resolution timeframe: 24-48 hours.",
    "contentJson": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"attrs\":{\"textAlign\":\"left\"}}]}",
    "isEdited": false,
    "threadName": null,
    "commentVisibility": "public",
    "commentType": "comment",
    "isPinned": false,
    "sourceEmailId": null,
    "metadata": {
      "mentions": []
    },
    "createdAt": "2025-07-24T09:31:03.888Z",
    "updatedAt": "2025-07-24T09:31:03.887Z",
    "author": "shakthi+1",
    "authorAvatarUrl": null,
    "attachments": [],
    "authorId": "UTH00SEXXFNVVN",
    "authorUserType": "ORG_ADMIN",
    "impersonatedUserEmail": null,
    "impersonatedUserName": null,
    "impersonatedUserAvatar": null,
    "deletedAt": null
  },
  "status": true,
  "message": "Comment created successfully!",
  "timestamp": "2025-07-24T09:31:04.071Z"
}
```

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

***