---
title: "Creates a new comment."
method: POST
path: "/comments/{documentId}"
tags: ["comments"]
---

# Creates a new comment.

`POST /comments/{documentId}`

## Path parameters

- `documentId` string, required

## Response `201`

Created

## Other responses

- `400` — Validation error
- `403` — API key is missing or invalid
- `404` — Document not found

## Changes

> 8 revisions in range; 1 not diffed.

- **2020-07-28** (v4) `90bf73788956` — 3 breaking, 9 warning, 9 info
  - request property `attributes/oneOf[#/components/schemas/AnonymousComment]/allOf[subschema #2]/submitterType` was restricted to a list of enum values
  - request property `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/submitterType` was restricted to a list of enum values
  - request property `attributes/oneOf[#/components/schemas/OrganizationComment]/allOf[subschema #2]/submitterType` was restricted to a list of enum values
  - added the new `Anonymous` enum value to the `attributes/allOf[subschema #1]/oneOf[#/components/schemas/AnonymousComment]/allOf[subschema #2]/submitterType` response property for the response status `201`
  - …17 more

[Change history](https://skmtc.dev/gsa/apis/regulations-gov-api/changes/comments/:documentId/post.md)

---

[API](https://skmtc.dev/gsa/apis/regulations-gov-api.md) · [All operations](https://skmtc.dev/gsa/apis/regulations-gov-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gsa/regulations-gov-api/revisions/0c7282b2ab56/schema)