---
title: "Post a comment"
method: POST
path: "/comments"
tags: ["Comments"]
---

# Post a comment

`POST /comments`

## Request

- Base URL: `https://app.buildworkpro.com/api/v1`
- URL: `https://app.buildworkpro.com/api/v1/comments`
- Auth: HTTP bearer

Creates a comment on a record and fans out @mention and thread notifications (in-app only, never email).

## Headers

- `Idempotency-Key` string, uuid

## Request body

- object
  - `entityType` string, required
  - `entityId` integer, required
  - `content` string, required
  - `parentId` integer, nullable

## Response `201`

Created

- object
  - `data` Comment, required
    - `id` integer, required
    - `entityType` string, required
    - `entityId` integer, required
    - `userId` integer, nullable, required
    - `content` string, required
    - `parentId` integer, nullable, required
    - `createdAt` union, required
      - string
      - string
    - `updatedAt` union, required
      - string
      - string

## Other responses

- `403`: Error

---

[API](https://skmtc.dev/buildworkpro/apis/buildworkpro-api.md) · [All operations](https://skmtc.dev/buildworkpro/apis/buildworkpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buildworkpro/apis/buildworkpro-api/revisions/441cf40012f7?raw)