Post a comment or a threaded reply. Files are attached by file_id from the file upload endpoints. Mentioned people are notified when they can see the conversation; others are left out
POST
https://app.softsolz.uk/api/v1/services/tasks/tasks/{id}/commentsRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Body Params
bodystringThe comment text. Optional when files are attached.
assignment_idintegerOmit for task-level discussion; set for the private reviewer-to-assignee thread.
parent_comment_idintegerThe comment being replied to.
mentionsarray of integersMember ids to mention.
file_idsarray of stringsUp to 10 file ids from the file upload endpoints.
Response
Response Body
idintegerComment id.task_idintegerTask the comment belongs to.assignment_idinteger | nullNull means task-level and visible to everyone on the task. Set means the private thread between one assignee and their reviewers.parent_comment_idinteger | nullThe comment this replies to.author_idinteger | nullWho wrote it.author_namestring | nullName of the author.bodystringThe comment text.created_atstringWhen it was posted.edited_atstring | nullWhen it was last edited, or null.mentionsarray of objectsPeople mentioned who can see this conversation.filesarray of objectsAttached files.Request
curl --request POST \ --url https://app.softsolz.uk/api/v1/services/tasks/tasks/{id}/comments \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "body": "Please redo section 4.", "mentions": [ 31 ]}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 201
{ "data": { "id": 3300, "task_id": 42, "assignment_id": null, "parent_comment_id": null, "author_id": 8, "author_name": "Sam", "body": "Please redo section 4.", "created_at": "2026-09-02T10:00:00.000Z", "edited_at": null, "mentions": [ { "user_id": 31, "name": "Alex" } ], "files": [ { "id": 120, "filename": "photo.jpg", "mime": "image/jpeg", "size_bytes": 48211, "download_url": "https://files.example.com/signed", "content_url": "/api/services/tasks/files/content?key=...", "text_url": "/api/services/tasks/files/text?key=..." } ] }}