> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a comment

> Add an activity comment to a task, record, or native meeting.

Add an activity comment to a task, record, or native meeting.

Use an OAuth access token issued to `kato-raycast`. Developer keys cannot call this endpoint. See [Raycast authentication](/api-reference/raycast/overview).

Required scopes: `comments:write`.

Tasks must be visible, records must be active in the workspace, and meetings require full detail access. Unavailable targets return `404`. A retry can add another comment; there is no comment idempotency token.

## Parameters

<ParamField body="entityType" type="string" required>
  task, record, or meeting.
</ParamField>

<ParamField body="entityId" type="string" required>
  Target ID, 1–200 characters.
</ParamField>

<ParamField body="comment" type="string" required>
  Trimmed comment text, 1–10,000 characters.
</ParamField>

## Response

**201** — Returns the resource under `data`. Example IDs and values are illustrative.

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "activityId": "activity_example"
    }
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error \
    "https://api.getkato.io/v1/raycast/comments" \
    -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    --data '{
    "entityType": "task",
    "entityId": "task_example",
    "comment": "Brief is ready for review."
  }'
  ```
</RequestExample>

This request changes workspace data. A timeout does not prove that the write failed; inspect the result before retrying.


## Related topics

- [Organize tasks](/documentation/organize-tasks.md)
- [All endpoints](/api-reference/endpoints.md)
- [Changelog](/changelog.md)
- [Add a record comment](/api-reference/records/comments-create.md)
- [Build an automation](/documentation/build-an-automation.md)