---
title: "Changes to Create a comment"
method: POST
path: "/posts/{postId}/comments"
---

# Changes to Create a comment

`POST /posts/{postId}/comments`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 3 revisions.

- **2026-07-17** `41c89b420e85` — 5 breaking, 1 info
- **2025-05-30** `2775bd09f55e` — 4 breaking, 3 warning, 6 info
- **2025-05-30** `dbaf42ae4311` — 10 breaking, 3 warning, 2 info

## Changes

- **2026-07-17** `41c89b420e85` — 5 breaking, 1 info
  - added the new path request parameter `postId`
  - the `content` response property's maxLength was increased from `500` to `1000` for the response status `201`
  - the `details` response's property type changed from `object` to `array` for status `400`
  - the `details` response's property type changed from `object` to `array` for status `404`
  - the `details` response's property type changed from `object` to `array` for status `500`
  - the `content` request property's maxLength was increased from `500` to `1000`
- **2025-05-30** `2775bd09f55e` — 4 breaking, 3 warning, 6 info
  - the `content` request property's minLength was increased from `0` to `1`
  - the `username` request property's minLength was increased from `0` to `1`
  - the `id` response's property type changed from `integer` to `string`, and format from no format to `uuid` for status `201`
  - the `postId` response's property type changed from `integer` to `string`, and format from no format to `uuid` for status `201`
  - deleted the `path` request parameter `postId`
  - the `content` request property's maxLength was set to `500`
  - the `username` request property's maxLength was set to `50`
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `404` status
  - added the optional property `details` to the response with the `500` status
  - added the required property `error` to the response with the `400` status
  - added the required property `error` to the response with the `404` status
  - added the required property `error` to the response with the `500` status
- **2025-05-30** `dbaf42ae4311` — 10 breaking, 3 warning, 2 info
  - for the `path` request parameter `postId`, the type changed from `string` to `integer`, and format from `uuid` to no format
  - the `content` response property's maxLength was unset from `1000` for the response status `201`
  - the `username` response property's maxLength was unset from `50` for the response status `201`
  - the `content` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `username` response property's minLength was decreased from `1` to `0` for the response status `201`
  - the `id` response's property type changed from `string` to `integer`, and format from `uuid` to no format for status `201`
  - the `postId` response's property type changed from `string` to `integer`, and format from `uuid` to no format for status `201`
  - removed the required property `error` from the response with the `400` status
  - removed the required property `error` from the response with the `404` status
  - removed the required property `error` from the response with the `500` status
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `404` status
  - removed the optional property `details` from the response with the `500` status
  - the `content` request property's minLength was decreased from `1` to `0`
  - the `username` request property's minLength was decreased from `1` to `0`

---

[Operation](https://skmtc.dev/azure/apis/simple-social-media-api/docs/posts/:postId/comments/post.md) · [API](https://skmtc.dev/azure/apis/simple-social-media-api.md) · [Page](https://skmtc.dev/azure/apis/simple-social-media-api/changes/posts/:postId/comments/post)