---
title: "POST /item/{itemId}/comment"
method: POST
path: "/item/{itemId}/comment"
tags: ["Work Items and OKRs"]
---

# POST /item/{itemId}/comment

`POST /item/{itemId}/comment`

Add a plain-text comment to a work item. Append-only (no edit/delete);
mentions not supported yet. Read comments back via get_item `fields=comments`.

## Path parameters

- `itemId` string, required

## Request body

- AddCommentRequest
  - `body` string, required — Plain-text comment body (non-empty). Mentions are not supported yet.

## Response `201`

The created comment id

- object
  - `id` string, required

## Other responses

- `401` — No access
- `404` — Item not found
- `422` — Invalid input

---

[API](https://skmtc.net/craft/apis/craft-io-public-api.md) · [All operations](https://skmtc.net/craft/apis/craft-io-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craft/craft-io-public-api/revisions/df0d980eb1e3/schema)