# task_comment_save

Comment on a Task

## Beschreibung

Posts a Markdown comment on a task; the body is converted to
Tiptap JSON for storage. Pair with `attachment_upload`
+ `attachment_ids` to ship screenshots / logs alongside the
comment.

## Zugriff

Zugriffsprofil: `gated`. Module: `projects_tasks`.
Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

## Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `account_id` | string | Ja |  |
| `task_id` | string | Ja | Task prefix or KEY-N. |
| `body_markdown` | string | Nein |  |
| `parent_id` | string | Nein | Prefix ID (cmt_…) of the comment this is a reply to. One level only — replying to a reply re-roots at the original parent. |
| `attachment_ids` | array | Nein | Attachment handles from `attachment_upload` — att_… ids or file_urls. Files appear under the comment in the task UI. |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "task_id": {
      "type": "string",
      "description": "Task prefix or KEY-N."
    },
    "body_markdown": {
      "type": "string"
    },
    "parent_id": {
      "type": "string",
      "description": "Prefix ID (cmt_…) of the comment this is a reply to. One level only — replying to a reply re-roots at the original parent."
    },
    "attachment_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attachment handles from `attachment_upload` — att_… ids or file_urls. Files appear under the comment in the task UI."
    }
  },
  "required": [
    "account_id",
    "task_id"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "comment": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "body_markdown": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "body_markdown"
      ]
    }
  },
  "required": [
    "comment"
  ],
  "type": "object"
}
```