Comments

Comment on a task

Posts a comment on one task, attributed to whoever the token belongs to. body is the only field, and unsafe HTML is stripped before it is stored. A task you cannot see returns 404.

Posting a comment notifies the people already following that task — its assignee and anyone subscribed to it. Who gets notified is decided entirely by the task, never by what the comment says.

@-mentions do not work here. Writing @Alex in body stores those characters and nothing more: it does not link to Alex, does not notify Alex, and there is no parameter that would. If you need to reach a specific person, this is not the endpoint for it.

Attachments are not supported either.

post/public-api/v1/tasks/{task_id}/comments

Request

  • Base URL
    https://app.hellobonsai.com
  • URL
    https://app.hellobonsai.com/public-api/v1/tasks/{task_id}/comments
  • Auth
    • OAuth 2
      Authorization code: https://app.hellobonsai.com/oauth/authorize
      Token URL: https://app.hellobonsai.com/oauth/token
    • or HTTP bearer

Path parameters

task_idstring required

The task to comment on — the task's uuid.

Request body

Example request

{
  "comment": {
    "body": "Looks good to me!"
  }
}

Response

The comment was posted.

Example response

{
  "data": {
    "id": 5821,
    "kind": "user_created",
    "commentable_type": "Task",
    "created_at": "2026-04-14T09:12:04.000Z",
    "body_plain_text": "Looks good to me!",
    "commentable_id": "ad3fdad8-5072-46df-8800-bb57299179df",
    "author_member_id": 314
  },
  "meta": {
    "request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.