Creates a new comment on the task with the specified id.

POST

1 curl -X POST https://api.awork.com/api/v1/tasks/taskId/comments \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "message": "Hey team, the customer loved the latest designs!",
6   "userId": "123e4567-e89b-12d3-a456-426614174000",
7   "previews": [
8     "https://www.awork.com/en/blog/automatic-project-management/"
9   ],
10   "isHiddenForConnectUsers": null
11 }'

Play

200Successful

1 {
2   "id": "123e4567-e89b-12d3-a456-426614174000",
3   "entityId": "123e4567-e89b-12d3-a456-426614174000",
4   "entityType": "tasks",
5   "entity": {
6     "id": "123e4567-e89b-12d3-a456-426614174000",
7     "name": null
8   },
9   "project": {
10     "id": "123e4567-e89b-12d3-a456-426614174000",
11     "name": null
12   },
13   "task": {
14     "id": "123e4567-e89b-12d3-a456-426614174000",
15     "name": null
16   },
17   "createdOn": "createdOn",
18   "createdBy": "123e4567-e89b-12d3-a456-426614174000",
19   "user": {
20     "id": "123e4567-e89b-12d3-a456-426614174000",
21     "firstName": null,
22     "lastName": null,
23     "hasImage": null,
24     "isExternal": false
25   },
26   "updatedOn": "updatedOn",
27   "updatedBy": "123e4567-e89b-12d3-a456-426614174000",
28   "mentions": {
29     "users": [
30       {
31         "id": "123e4567-e89b-12d3-a456-426614174000",
32         "firstName": null,
33         "lastName": null,
34         "hasImage": null,
35         "isExternal": false
36       }
37     ],
38     "everyUserHadPermissions": true
39   },
40   "reactions": [
41     {
42       "userId": "123e4567-e89b-12d3-a456-426614174000",
43       "emoji": "👍"
44     }
45   ],
46   "formattedMessage": "Hey team, the customer loved the latest designs!",
47   "plainFormattedMessage": "Hey team, the customer loved the latest designs!",
48   "resourceVersion": 637825154598057900,
49   "message": "Hey team, the customer loved the latest designs!",
50   "userId": "123e4567-e89b-12d3-a456-426614174000",
51   "previews": [
52     "https://www.awork.com/en/blog/automatic-project-management/"
53   ],
54   "isHiddenForConnectUsers": false
55 }

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

taskIdUUIDRequired

The id of the task.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

messagestringRequired>=1 character<=65000 characters

The message of the comment.

userIdUUID or nullOptional

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.

isHiddenForConnectUsersboolean or nullOptional

(optional) Whether the comment is hidden for connect users. Providing a null value will not change the current state. By default, comments are not hidden for connect users.

Response

idUUIDOptional

The id of the comment.

entityIdUUIDOptional

The id of the entity of the comment. Required.

entityTypestring or nullOptional

The type of the entity of the comment. Can be “projects”, “tasks”. Required.

entityobjectOptional

projectobjectOptional

taskobjectOptional

createdOndatetimeOptional

The date this object was created.

createdByUUIDOptional

The id of the user who created this object.

userobjectOptional

updatedOndatetimeOptional

The date this object was last modified.

updatedByUUIDOptional

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.

formattedMessagestring or nullOptional

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.

plainFormattedMessagestring or nullOptional

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.

messagestring or nullOptional

The message of the comment.

userIdUUID or nullOptional

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.

isHiddenForConnectUsersbooleanOptional

True if the comment should be hidden to connect users.