Posts

Create a new post

Create a new post to share something with others

post/posts

Request body

usernamestring required

Username of the post author

contentstring required

Content of the post

Example request

{
  "username": "john_doe",
  "content": "Just had an amazing hike in the mountains! #outdoorlife"
}

Response

Post created 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.17411

  • 41c89b420e8531See the full diff
    • 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 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

  • 2775bd09f55e526See the full diff
    • the request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • 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

    • the request property's maxLength was set to 1000

      request-property-max-length-set

    • the request property's maxLength was set to 50

      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 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

  • dbaf42ae4311924See the full diff
    • 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 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

    • 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