---
title: "Create task comment"
method: POST
path: "/comment/{taskId}"
tags: ["Comments"]
---

# Create task comment

`POST /comment/{taskId}`

Add a comment to a task. Mentions in the content notify the mentioned users, and the assignee is notified too. Returns the stored activity row, which carries no author object -- read the list route for that.

## Path parameters

- `taskId` string, required

## Request body

- object
  - `content` string, required
  - `externalUserName` string — Attribution for an imported comment. Ignored unless externalSource is also given.
  - `externalSource` 'planka' | 'trello' | 'jira' — The tool the comment was imported from.

## Response `200`

The created comment

- Activity
  - `id` string, required
  - `taskId` string, required
  - `type` string, required — One of: comment, task, create, status_changed, priority_changed, assignee_changed, unassigned, due_date_changed, title_changed, description_changed.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `userId` string, nullable, required
  - `content` string, nullable, required
  - `eventData` unknown
  - `externalUserName` string, nullable, required — Set when the activity was imported from another tool.
  - `externalUserAvatar` string, nullable, required
  - `externalSource` string, nullable, required — The tool it was imported from, e.g. planka, trello, jira.
  - `externalUrl` string, nullable, required

## Other responses

- `400` — Invalid body, or unknown task
- `401` — Missing or invalid credentials
- `403` — No workspace access, or missing task:update permission

## Changes

- **2026-08-24** `08bbb5bedb5d` — 2 breaking, 1 warning, 11 info
  - the response property `content` became nullable for the status `200`
  - the response property `userId` became nullable for the status `200`
  - removed the optional property `user` from the response with the `200` status
  - added the new optional request property `externalSource`
  - …10 more
- **2026-07-11** `32cece1ebe43` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/comment/:taskId/post.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) · [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usekaneo/kaneo-api/revisions/9d1da42c10ce/schema)