SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Tasks

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

POSThttps://app.softsolz.uk/api/v1/services/tasks/tasks/{id}/comments

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Body Params

bodystring

The comment text. Optional when files are attached.

assignment_idinteger

Omit for task-level discussion; set for the private reviewer-to-assignee thread.

parent_comment_idinteger

The comment being replied to.

mentionsarray of integers

Member ids to mention.

file_idsarray of strings

Up 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=..."
}
]
}
}