taskComments

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

Changed on

Creates a new comment on the task with the specified id. A user can only create a comment for him/herself, except for admins and api users.

        <Check title="Required Permissions" icon="key">To create a comment the user must have at least `read` permissions on the specified task.</Check>
post/tasks/{taskId}/comments

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/tasks/{taskId}/comments
  • Auth: HTTP bearer

Path parameters

taskIdstring uuid required

The id of the task to create the comment for.

Request body

messagestring required

The message of the comment.

userIdstring uuid nullable

The id of the user who created the comment. Optional. If not set, defaults to the current user.

previewsstring[] nullable

The preview URLs to show a preview for.

isHiddenForConnectUsersboolean nullable

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

isResolvedboolean nullable

Whether the comment has been resolved. Only available for comments on documents.

inReplyToCommentIdstring uuid nullable

The parent comment this comment is a reply to.

Response

OK

idstring uuid

The id of the comment.

entityIdstring uuid

The id of the entity of the comment. Required.

entityTypestring nullable

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

createdOnstring date-time

The date this object was created.

createdBystring uuid

The id of the user who created this object.

agentIdstring uuid nullable

The agent that visibly authored this comment, when it was created by an agent run.

agentNameSnapshotstring nullable

The agent name captured when the comment was created.

updatedOnstring date-time

The date this object was last modified.

updatedBystring uuid

The id of the user who last modified this object.

formattedMessagestring nullable

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 nullable

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.

resourceVersioninteger

The version of the entity, updated on every modification, to the ticks in UTC. Not identical to UpdatedOn.

messagestring nullable

The message of the comment.

userIdstring uuid nullable

The id of the user who created the comment. Optional. If not set, defaults to the current user.

previewsstring[] nullable

The preview URLs to show a preview for.

isHiddenForConnectUsersboolean

True if the comment should be hidden to connect users.

isResolvedboolean nullable

Whether the comment has been resolved. Only available for comments on documents.

inReplyToCommentIdstring uuid nullable

The parent comment this comment is a reply to.

Changes

  • eadefd26df12Revision changes
    • info

      added the optional property / to the response with the status

  • 1556e0487867Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API