For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeveloper ForumLogin
  • Overview
    • Introduction
    • Getting Started
    • Integration Example (PSA)
    • Authentication
    • Error Handling
    • Pagination
    • Filtering
    • Ordering
    • Rate Limits
    • Permissions
    • Webhooks
    • MCP Server
    • Versioning
    • Changelog
    • Support
  • API v1 Reference
    • Projects Overview
    • Tasks Overview
      • GETReturns all comments of the task with the specified id.
      • POSTCreates a new comment on the task with the specified id.
      • DELDeletes all comments of the specified task.
      • GETReturns the comment with the specified id of the task with the specified id.
      • PUTUpdates the comment with the specified id on the task with the specified id.
      • DELDeletes the comment with the specified id on the task with the specified id.
      • POSTUpdates the reactions of the comment with the specified id on the task with the specified id.
    • Time Tracking Overview
    • Documents Overview
    • Search Overview
    • Companies Overview
    • Users Overview
    • Files & Images Overview
    • Custom Fields Overview
    • Workload & Planning Overview
    • Project Templates Overview
    • Workflows Overview
    • Login & Access Overview
    • API Management Overview
LogoLogo
SupportDeveloper ForumLogin
API v1 ReferenceTask Comments

Updates the comment with the specified id on the task with the specified id.

PUT
https://api.awork.com/api/v1/tasks/:taskId/comments/:commentId
PUT
/api/v1/tasks/:taskId/comments/:commentId
$curl -X PUT https://api.awork.com/api/v1/tasks/taskId/comments/commentId \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "message": "Hey team, the customer loved the latest designs!"
>}'
1{
2  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
3  "entityId": "a3bb189e-8bf9-3888-9912-ace4e6543002",
4  "entityType": "tasks",
5  "entity": {
6    "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
7    "name": "Website Redesign"
8  },
9  "project": {
10    "id": "b1c2d3e4-f567-8901-2345-6789abcdef01",
11    "name": "Q2 Marketing Campaign"
12  },
13  "task": {
14    "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
15    "name": "Design Landing Page"
16  },
17  "document": {
18    "id": "d4e5f6a7-b890-1234-5678-9abcdef01234",
19    "name": "LandingPageSpecs.pdf"
20  },
21  "createdOn": "2024-01-15T09:30:00Z",
22  "createdBy": "c9b1d2e3-f456-7890-abcd-ef1234567890",
23  "user": {
24    "id": "c9b1d2e3-f456-7890-abcd-ef1234567890",
25    "firstName": "Carla",
26    "lastName": "Creative",
27    "hasImage": true,
28    "isExternal": false
29  },
30  "updatedOn": "2024-01-15T09:30:00Z",
31  "updatedBy": "c9b1d2e3-f456-7890-abcd-ef1234567890",
32  "mentions": {
33    "users": [
34      {
35        "id": "c9b1d2e3-f456-7890-abcd-ef1234567890",
36        "firstName": "Carla",
37        "lastName": "Creative",
38        "hasImage": true,
39        "isExternal": false
40      }
41    ],
42    "everyUserHadPermissions": true
43  },
44  "reactions": [
45    {
46      "userId": "c9b1d2e3-f456-7890-abcd-ef1234567890",
47      "emoji": "👍"
48    }
49  ],
50  "formattedMessage": "Hey team, the customer loved the latest designs!",
51  "plainFormattedMessage": "Hey team, the customer loved the latest designs!",
52  "resourceVersion": 637825154598057900,
53  "message": "Hey team, the customer loved the latest designs!",
54  "userId": "c9b1d2e3-f456-7890-abcd-ef1234567890",
55  "previews": [
56    "https://www.awork.com/en/blog/automatic-project-management/"
57  ],
58  "isHiddenForConnectUsers": true,
59  "isResolved": true,
60  "inReplyToCommentId": "e7b8c9d0-1234-5678-9abc-def012345678"
61}
<Check title="Required Permissions" icon="key">To update a comment the user must either have at least `read` permissions on the specified task, be the creator of the comment or be admin.</Check>
Was this page helpful?
Previous

Deletes the comment with the specified id on the task with the specified id.

Next
Built with
Required Permissions
To update a comment the user must either have at least read permissions on the specified task, be the creator of the comment or be admin.

Authentication

AuthorizationBearer

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

Path parameters

taskIdstringRequiredformat: "uuid"
The id of the task.
commentIdstringRequiredformat: "uuid"
The id of the comment.

Request

The model with the updated comment information.
messagestringRequired1-65000 characters
The message of the comment.
userIdstring or nullOptionalformat: "uuid"
The id of the user who created the comment. Optional. If not set, defaults to the current user.
previewslist of strings or nullOptional
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.

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

Response

OK
idstringformat: "uuid"
The id of the comment.
entityIdstringformat: "uuid"
The id of the entity of the comment. Required.
entityTypestring or null
The type of the entity of the comment. Can be "projects", "tasks". Required.
entityobject
projectobject
taskobject
documentobject
createdOnstringformat: "date-time"
The date this object was created.
createdBystringformat: "uuid"
The id of the user who created this object.
userobject
updatedOnstringformat: "date-time"
The date this object was last modified.
updatedBystringformat: "uuid"
The id of the user who last modified this object.
mentionsobject
A mention is the tag of a user on a specific comment, so the user is notified.
reactionslist of objects or null
The reactions on a comment.
formattedMessagestring or null
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 null
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.
resourceVersionlongRead-only
The version of the entity, updated on every modification, to the ticks in UTC. Not identical to UpdatedOn.
messagestring or null
The message of the comment.
userIdstring or nullformat: "uuid"
The id of the user who created the comment. Optional. If not set, defaults to the current user.
previewslist of strings or null
The preview URLs to show a preview for.
isHiddenForConnectUsersboolean
True if the comment should be hidden to connect users.
isResolvedboolean or null
Whether the comment has been resolved. Only available for comments on documents.
inReplyToCommentIdstring or nullformat: "uuid"
The parent comment this comment is a reply to.

Errors

401
Unauthorized Error
404
Not Found Error