Creates a new comment on the task with the specified id.
POST
Creates a new comment on the task with the specified id.
The user needs read permissions on the task to create a comment.
A user can only create a comment for him/herself, except for admins and api users.
Path parameters
taskIdstringRequiredThe id of the task.
Request
This endpoint expects an object.
messagestringRequired
The message of the comment.
userIdstringOptional
The id of the user who created the comment.
Optional. If not set, defaults to the current user.
previewslist of stringsOptional
The preview URLs to show a preview for.
Response
This endpoint returns an object
messagestring
The message of the comment.
userIdstringOptional
The id of the user who created the comment.
Optional. If not set, defaults to the current user.
previewslist of stringsOptional
The preview URLs to show a preview for.
idstringOptional
The id of the comment.
entityIdstringOptional
The id of the entity of the comment.
Required.
entityTypestringOptional
The type of the entity of the comment.
Can be "projects", "tasks".
Required.
entityobjectOptional
projectobjectOptional
createdOndatetimeOptional
The date this object was created.
createdBystringOptional
The id of the user who created this object.
userobjectOptional
updatedOndatetimeOptional
The date this object was last modified.
updatedBystringOptional
The id of the user who last modified this object.
mentionsobjectOptional
A mention is the tag of a user on a specific comment, so the user is notified.
reactionslist of objectsOptional
The reactions on a comment.
formattedMessagestringOptional
The formatted and proccessed version of the comment message. E.g. mentions are in a human readable format.
The formatted comment message is styled with html.
plainFormattedMessagestringOptional
The formatted and proccessed version of the comment message. E.g. mentions are in a human readable format.
The formatted comment message is not styled.
resourceVersionlongOptional
The version of the entity, updated on every modification, to the ticks in UTC.
Not identical to UpdatedOn.