Skip to main content
POST
Create task comment

Authorizations

Authorization
string
header
required

API key or session token (Bearer)

Path Parameters

taskId
string
required

Body

application/json
content
string
required
Required string length: 1 - 10000
externalUserName
string

Attribution for an imported comment. Requires workspace:manage_settings and externalSource; otherwise ignored.

Maximum string length: 120
externalSource
enum<string>

The tool the comment was imported from. Supplying external attribution requires workspace:manage_settings.

Available options:
planka,
trello,
jira,
plane,
linear,
kaneo

Response

The created comment

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 | null
required
content
string | null
required
externalUserName
string | null
required

Set when the activity was imported from another tool.

externalUserAvatar
string | null
required
externalSource
string | null
required

The tool it was imported from: planka, trello, jira, plane, linear, kaneo, or a connected forge such as github.

externalUrl
string | null
required
eventData
any

Type-specific payload, e.g. { oldStatus, newStatus } for status_changed. Null for plain comments.