---
title: "Changes to Creates a new comment."
method: POST
path: "/comments"
---

# Changes to Creates a new comment.

`POST /comments`

> Every recorded change to this operation, newest first.
> 25 revisions in range; 1 not diffed.

## Timeline

Changed in 6 of 25 revisions.

- **2026-07-02** (v4) `be43c866f5ca`: 1 info
- **2025-10-01** (v4) `08d76fb673bd`: 1 breaking
- **2021-06-30** (v4) `dee93213b6f7`: 1 breaking, 1 warning, 1 info
- **2021-06-30** (v4) `a12b7cc49b54`: 2 breaking, 13 warning
- **2020-10-08** (v4) `d0e8bbadd163`: 3 breaking, 1 warning, 3 info
- **2020-08-27** (v4) `b19d0ba95476`: 1 info

## Changes

- **2026-07-02** (v4) `be43c866f5ca`: 1 info
  - endpoint added
- **2025-10-01** (v4) `08d76fb673bd`: 1 breaking
  - api removed without deprecation
- **2021-06-30** (v4) `dee93213b6f7`: 1 breaking, 1 warning, 1 info
  - the `attributes/allOf[subschema #1]/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/phone` response property's maxLength was increased from `25` to `50` for the response status `201`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/lastName` request property's maxLength was set to `25`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/phone` request property's maxLength was increased from `25` to `50`
- **2021-06-30** (v4) `a12b7cc49b54`: 2 breaking, 13 warning
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/stateProvinceRegion` request property type changed from `boolean` to `string`
  - the `attributes/allOf[subschema #1]/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/stateProvinceRegion` response's property type changed from `boolean` to `string` for status `201`
  - the `attributes/oneOf[#/components/schemas/AnonymousComment]/allOf[#/components/schemas/BaseCommentPayload]/comment` request property's maxLength was set to `5000`
  - the `attributes/oneOf[#/components/schemas/AnonymousComment]/allOf[#/components/schemas/BaseCommentPayload]/email` request property's maxLength was set to `100`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[#/components/schemas/BaseCommentPayload]/comment` request property's maxLength was set to `5000`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[#/components/schemas/BaseCommentPayload]/email` request property's maxLength was set to `100`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/city` request property's maxLength was set to `50`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/country` request property's maxLength was set to `50`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/firstName` request property's maxLength was set to `25`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/phone` request property's maxLength was set to `25`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/stateProvinceRegion` request property's maxLength was set to `50`
  - the `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[subschema #2]/zip` request property's maxLength was set to `10`
  - the `attributes/oneOf[#/components/schemas/OrganizationComment]/allOf[#/components/schemas/BaseCommentPayload]/comment` request property's maxLength was set to `5000`
  - the `attributes/oneOf[#/components/schemas/OrganizationComment]/allOf[#/components/schemas/BaseCommentPayload]/email` request property's maxLength was set to `100`
  - the `attributes/oneOf[#/components/schemas/OrganizationComment]/allOf[subschema #2]/organization` request property's maxLength was set to `120`
- **2020-10-08** (v4) `d0e8bbadd163`: 3 breaking, 1 warning, 3 info
  - the response property `attributes/allOf[subschema #1]/oneOf[#/components/schemas/AnonymousComment]/allOf[#/components/schemas/BaseCommentPayload]/submissionKey` became optional for the status `201`
  - the response property `attributes/allOf[subschema #1]/oneOf[#/components/schemas/IndividualComment]/allOf[#/components/schemas/BaseCommentPayload]/submissionKey` became optional for the status `201`
  - the response property `attributes/allOf[subschema #1]/oneOf[#/components/schemas/OrganizationComment]/allOf[#/components/schemas/BaseCommentPayload]/submissionKey` became optional for the status `201`
  - removed the request property `id`
  - the request property `attributes/oneOf[#/components/schemas/AnonymousComment]/allOf[#/components/schemas/BaseCommentPayload]/submissionKey` became optional
  - the request property `attributes/oneOf[#/components/schemas/IndividualComment]/allOf[#/components/schemas/BaseCommentPayload]/submissionKey` became optional
  - the request property `attributes/oneOf[#/components/schemas/OrganizationComment]/allOf[#/components/schemas/BaseCommentPayload]/submissionKey` became optional
- **2020-08-27** (v4) `b19d0ba95476`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/gsa/apis/regulations-gov-api/docs/comments/post.md) - [API](https://skmtc.dev/gsa/apis/regulations-gov-api.md) - [Page](https://skmtc.dev/gsa/apis/regulations-gov-api/changes/comments/post)