Create a task comment

Tasks View as Markdown

POST/api/task/{taskId}/comment

Accepts an editor doc (TipTap JSON) or a markdown string; stored as markdown.

Parameters

taskIdintegerpathRequired: ID of the task.

Request body

docobject: Comment body as a rich-text document (ProseMirror/Tiptap JSON). Send either doc or markdown.
markdownstring: Comment body as Markdown (up to 20,000 characters). Takes precedence over doc if both are sent.
parentIdinteger | null: ID of the comment to reply to. Omit or null to post a top-level comment.

Responses

200Created comment
400Empty body or invalid parent
401Authentication is required
403Not a project member
404Task not found

Request

curl -X POST "https://<space>.repsona.com/api/task/{taskId}/comment" \
  -H "Authorization: Bearer $REPSONA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "I rewrote the hero section. Could you take a look before Friday?",
    "parentId": null
  }'

Example response

{
  "comment": {
    "id": 75,
    "parentId": null,
    "comment": "I rewrote the hero section. Could you take a look before Friday?",
    "createdAt": 1793662651194,
    "updatedAt": 1793662651194,
    "user": {
      "id": 1127,
      "name": "emma",
      "fullName": "Emma Carter",
      "avatarUrl": null,
      "color": null,
      "state": "active"
    },
    "files": [],
    "deleted": false,
    "reactions": [],
    "children": []
  }
}