# Creates a new top-level comment in a discussion. Requires authenticated user and triggers real-time notifications.

**POST /api/v1/discussions/{discussionId}/comments**




## Servers
- Production: https://crowdparlay.com (Production)



## Parameters

### Path parameters
- **discussionId** (string)
  The unique identifier of the discussion being commented.


### Body: application/json (object)
The comment content and target discussion identifier.
- **content** (string)



## Responses
### 201
Created

#### Body: application/json (object)
- **id** (string)

- **subject_id** (string)

- **content** (string)

- **author** (object | null)

- **created_at** (string(date-time))

- **comment_count** (integer(int32))

- **last_comments_authors** (array[object])

- **reaction_counters** (object)

- **viewer_reactions** (array[string])


### 400
Bad Request

#### Body: application/json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)

- **errors** (object)


### 403
Forbidden

#### Body: application/json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)


### 500
Internal Server Error

#### Body: application/json (object)
- **type** (string | null)

- **title** (string | null)

- **status** (integer(int32) | null)

- **detail** (string | null)

- **instance** (string | null)



[Powered by Bump.sh](https://bump.sh)