Skip to main content

​
MCP tool: create_ticket_comment

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

​
Example prompt

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

​
Input parameters

NameTypeRequiredDescription
idstringYesThe ID of the ticket to comment on
contentstringYesThe content of the comment
contentHtmlstringNoThe HTML content of the comment
contentJsonstringNoThe JSON content of the comment
threadNamestringNoThe name of the comment thread
parentCommentIdstringNoThe ID of the parent comment
commentVisibilitystringNoComment visibility (e.g., “public”)
commentTypestringNoType of comment (e.g., “comment”)
customerEmailstringNoThe email of the customer
metadataobjectNoAdditional metadata
attachmentIdsstring[]NoIDs of attachments
impersonatedUserEmailstringNoEmail of impersonated user
impersonatedUserNamestringNoName of impersonated user
impersonatedUserAvatarstringNoAvatar of impersonated user
shouldSendEmailbooleanNoWhether to send an email notification
createdAtstringNoCreation timestamp (ISO8601)

​
Response fields

Below are the fields you may see in the response:
FieldTypeDescription
idstringComment unique ID
contentstringComment text
contentHtmlstringHTML content
contentMarkdownstringMarkdown content
contentJsonstringJSON content
isEditedbooleanWhether the comment was edited
threadNamestringThread name
commentVisibilitystringComment visibility
commentTypestringType of comment
isPinnedbooleanWhether the comment is pinned
sourceEmailIdstringSource email ID
metadataobjectMetadata (e.g., mentions)
createdAtstringCreation timestamp (ISO8601)
updatedAtstringLast update timestamp (ISO8601)
authorstringAuthor username or email
authorAvatarUrlstringAuthor avatar URL
attachmentsarrayList of attachment objects
authorIdstringAuthor user ID
authorUserTypestringAuthor user type (e.g., “ORG_ADMIN”)
impersonatedUserEmailstringImpersonated user email
impersonatedUserNamestringImpersonated user name
impersonatedUserAvatarstringImpersonated user avatar
deletedAtstringDeletion timestamp (if deleted)
Other top-level fields in the response:
FieldTypeDescription
dataobjectThe created comment object
statusbooleanWhether the creation succeeded
messagestringStatus message
timestampstringTime the response was generated (ISO8601)

​
Sample response

{
  "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"
}