Skip to content

POST/comments

Create comment

Create a new comment. Fields `id`, `createdAt`, `updatedAt` are auto-generated. Triggers `comments.created` webhook.

ReturnsComment

AcceptsCommentInput

Bearer token required

Response examples

201Comment created

application/json example derived from schema

{
  "id": 1,
  "postId": 1,
  "userId": 1,
  "body": "How does this compare to the approach described in the official docs?",
  "likes": 16,
  "createdAt": "2023-04-28T06:59:47.906Z"
}
400400 — invalid input or malformed JSON

application/json

{
  "error": {
    "status": 400,
    "message": "Request body required"
  }
}
413413 — body exceeds 64 KB

application/json

{
  "error": {
    "status": 413,
    "message": "Request body too large",
    "details": {
      "maxSize": "64 KB"
    }
  }
}
429429 — rate limit exceeded (120/60s)

application/json

{
  "error": {
    "status": 429,
    "message": "Too many requests",
    "details": {
      "retryAfter": 45
    }
  }
}

Released under the MIT License.