Posts

Update a post

Update an existing post if you made a mistake or have something to add

patch/posts/{postId}

Path parameters

postIdstring uuid required

Example:123e4567-e89b-12d3-a456-426614174000

Unique identifier of the post

Request body

usernamestring required

Username of the post author (for validation)

contentstring required

Updated content of the post

Example request

{
  "username": "john_doe",
  "content": "Just had an amazing hike in the mountains! The view was breathtaking. #outdoorlife #hiking"
}

Response

Post updated successfully

idstring uuid required

Unique identifier for the post

usernamestring required

Username of the post author

contentstring required

Content of the post

createdAtstring date-time required

Timestamp when the post was created

updatedAtstring date-time required

Timestamp when the post was last updated

likesCountinteger required

Number of likes on the post

commentsCountinteger required

Number of comments on the post

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "username": "john_doe",
  "content": "Just had an amazing hike in the mountains! #outdoorlife",
  "createdAt": "2025-06-01T10:30:00Z",
  "updatedAt": "2025-06-01T10:30:00Z",
  "likesCount": 15,
  "commentsCount": 3
}

Changes

Changed in 3 of the 3 revisions of this API.21612

Jul 17, 202641c89b420e8551See the full diff
- ▲
  added the new path request parameter postId
  new-request-path-parameter
- ▲
  the response property's maxLength was increased from 1000 to 2000 for the response status
  response-property-max-length-increased
- ▲
  the response's property type changed from object to array for status
  response-property-type-changed
- ▲
  the response's property type changed from object to array for status
  response-property-type-changed
- ▲
  the response's property type changed from object to array for status
  response-property-type-changed
- ○
  the request property's maxLength was increased from 1000 to 2000
  request-property-max-length-increased
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 30, 20252775bd09f55e528See the full diff
- ▲
  added the new required request property
  new-required-request-property
- ▲
  the request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the response's property type changed from integer to string, and format from no format to uuid for status
  response-property-type-changed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ●
  deleted the path request parameter postId
  request-parameter-removed
- ●
  the request property's maxLength was set to 1000
  request-property-max-length-set
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
May 30, 2025dbaf42ae43111143See the full diff
- ▲
  for the path request parameter postId, the type changed from string to integer, and format from uuid to no format
  request-parameter-type-changed
- ▲
  the response property's maxLength was unset from 2000 for the response status
  response-property-max-length-unset
- ▲
  the response property's maxLength was unset from 50 for the response status
  response-property-max-length-unset
- ▲
  the response property's minLength was decreased from 1 to 0 for the response status
  response-property-min-length-decreased
- ▲
  the response property's minLength was decreased from 1 to 0 for the response status
  response-property-min-length-decreased
- ▲
  the response's property type changed from string to integer, and format from uuid to no format for status
  response-property-type-changed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ●
  removed the request property
  request-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ○
  the request property's minLength was decreased from 1 to 0
  request-property-min-length-decreased
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history